IViewRowset::GetSpecification

Returns the object from which the view was created.

Syntax

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.