OLE DB Programmer's Reference

ICommand::GetDBSession

Returns an interface pointer to the session that created the command.

HRESULT GetDBSession (
   REFIID       riid,
   IUnknown   **ppSession);

Parameters

riid
[in]
The IID of the interface on which to return a pointer.
ppSession
[out]
A pointer to memory in which to return the interface pointer. If the provider does not have an object that created the command, it sets *ppSession to a null pointer. If ICommand::GetDBSession fails, it must attempt to set *ppSession to a null pointer.

Return Code

S_OK
The method succeeded.
S_FALSE
The provider did not have an object that created the command. Therefore, it set *ppSession to a null pointer.
E_FAIL
A provider-specific error occurred.
E_INVALIDARG
ppSession was a null pointer.
E_NOINTERFACE
The session did not support the interface specified in riid.

Comments

If the provider is an OLE DB 2.5 or later provider that implements IDBCreateCommand on the row object to support scoped commands, calling ICommand::GetDBSession on a row-scoped command returns an interface pointer on the row object's underlying session object.