GetActiveObject

HRESULT GetActiveObject( 
  REFCLSID  rclsid,       
  void FAR*  pvReserved,  
  IUnknown FAR* FAR*  ppunk  
);
 

Retrieves a pointer to a running object that has been registered with OLE.

Parameters

rclsid
Pointer to the class identifier (CLSID) of the active object from the OLE registration database.
pvReserved
Reserved for future use. Must be Null.
ppunk
On return, a pointer to the requested active object.

Return Value

The return value obtained from the returned HRESULT is one of the following:

Return value Meaning
S_OK Success.
Other return codes Failure.

QuickInfo

  Windows NT: Use version 3.1 and later.
  Windows: Use Windows 95 and later.
  Header: Declared in oleauto.h.
  Import Library: Link with oleaut32.lib.