IMDDataset::GetSpecification

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

Syntax

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.