ICommand::GetDBSession

OLE DB Programmer's Reference

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.

1998-2001 Microsoft Corporation. All rights reserved.



Microsoft Ole Db 2.0 Programmer's Reference and Data Access SDK
Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)
ISBN: 0735605904
EAN: 2147483647
Year: 1998
Pages: 1083

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net