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 doesn’t 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 doesn’t 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.