GetActiveObject function

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

Syntax

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

Parameters

rclsid

The class identifier (CLSID) of the active object from the OLE registration database.

pvReserved

Reserved for future use. Must be null.

ppunk

The requested active object.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

   
Target Platform Windows
Header oleauto.h
Library OleAut32.lib
DLL OleAut32.dll