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

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.