_com_ptr_t::GetActiveObject

Microsoft 专用

附加到给定 CLSIDProgID 的对象的现有实例。

语法

HRESULT GetActiveObject(
   const CLSID& rclsid
) throw( );
HRESULT GetActiveObject(
   LPCWSTR clsidString
) throw( );
HRESULT GetActiveObject(
   LPCSTR clsidStringA
) throw( );

参数

rclsid
对象的 CLSID

clsidString
一个包含(以“{CLSID”开头的)ProgID 的 Unicode 字符串。

clsidStringA
使用 ANSI 代码页并包括(以 "CLSID" 开头)的 ProgID 的多字节字符串。

备注

这些成员函数调用 GetActiveObject 来检索指向已向 OLE 注册的正在运行对象的指针,然后查询此智能指针的接口类型。 生成的指针随后将封装在此 _com_ptr_t 对象内。 调用 Release 以减少前面封装的指针的引用计数。 此例程返回 HRESULT 以指示成功或失败。

  • GetActiveObject(rclsid)附加到给定 CLSID 的对象的现有实例。

  • GetActiveObject(clsidString) 附加到包含 CLSID(以 "{" 开头)或 ProgID 的给定 Unicode 字符串的对象的现有实例。

  • GetActiveObject(clsidStringA) 附加到包含(以 "{CLSID" 开头)的 ProgID 的给定多字节字符串的对象的现有实例。 调用 MultiByteToWideChar,假定字符串是在 ANSI 代码页中而不是 OEM 代码页中。

结束 Microsoft 专用

另请参阅

_com_ptr_t 类