Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)
| 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.