Returns a data access object (such as a row position) for a given data member.
HRESULT getDataMember (
DataMemberbstrDM
REFIIDriid
IUnknown** ppunk);
Parameters
bstrDM
[in]
A string that describes the data member that represents one or more sets of data supported by the data source. This string is interpreted as case-insensitive.
riid
[in]
The interface identifier of the specified data access object.
ppunk
[out]
The pointer of the returned interface.
Return Codes
S_OK
The method succeeded.
E_FAIL
A provider-specific error occurred.
E_NOINTERFACE
Does not support the specified data access object.
Comments
The default data member is specified by having either a zero-length string or a Null string (they are equivalent). If the data source does not support the desired data access object, it returns E_NOINTERFACE.
Note The return value from getDataMember is always an IUnknown pointer. It is the responsibility of the caller of the method to query for the appropriate interface. That is, the IID parameter does not specify which interface, but rather which data access object type to return.