IViewRowset::GetSpecification

OLE DB Programmer's Reference

Returns the object from which the view was created.

HRESULT GetSpecification (    REFIID        riid,    IUnknown    **ppObject);

Parameters

riid
[in]
The IID of the interface to be returned. This interface is conceptually added to the list of required interfaces on the resulting rowset, and the method fails (E_NOINTERFACE) if that interface cannot be supported on the resulting rowset.
ppObject
[out]
A pointer to memory in which to return the interface pointer. If IViewRowset::GetSpecification fails, it must attempt to set *ppObject to a null pointer.

Return Code

S_OK
The method succeeded.
E_FAIL
A provider-specific error occurred.
E_NOINTERFACE
The view did not support the interface specified in riid.
E_OUTOFMEMORY
The provider was unable to allocate sufficient memory in which to return the object information.

Comments

IViewRowset::GetSpecification adds a reference count to the object. The consumer must call Release to release the reference count when it is no longer needed.

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