Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)

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

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.

1998-2001 Microsoft Corporation. All rights reserved.