MDAC 2.5 SDK - OLE DB Programmer's Reference
OLE DB for OLAP Interfaces

IMDDataset::GetSpecification

Returns an interface pointer on the command object that created the dataset.

HRESULT GetSpecification (
   REFIID        riid,
   IUnknown **   ppSpecification);

Parameters

riid

[in]
The IID of the interface on which to return a pointer.

ppSpecification

[out]
A pointer to memory in which to return the interface pointer. If the provider does not have an object that created the dataset, it sets ppSpecification to a null pointer and returns S_FALSE. If IMDDataset::GetSpecification fails, it must attempt to set ppSpecification to a null pointer.

Return Code

S_OK

The method succeeded.

S_FALSE

The provider does not have a command object that created the dataset.

E_FAIL

A provider-specific error occurred.

E_INVALIDARG

ppSpecification was a null pointer.

E_NOINTERFACE

The object that created this dataset did not support the interface specified in riid.

Comments

This method makes no logical change to the state of the current dataset.