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.