GetActiveObject function (oleauto.h)

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

HRESULT GetActiveObject(
  [in]  REFCLSID rclsid,
        void     *pvReserved,
  [out] IUnknown **ppunk
);

[in] rclsid

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

pvReserved

Reserved for future use. Must be null.

[out] ppunk

The requested active object.

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