_com_ptr_t::GetActiveObject

Microsoft 特定的

附加至指定 CLSID 或 ProgID 之物件的現有實例。

語法

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

參數

rclsid
CLSID物件的 。

clsidString
一個 Unicode 字串，保留 CLSID （開頭為 「 { 」） 或 ProgID 。

clsidStringA
使用 ANSI 字碼頁的多位元組字元串，保留 CLSID （開頭為 「 { 」） 或 ProgID 。

備註

這些成員函式會呼叫 GetActiveObject 來擷取已向 OLE 註冊的執行中物件的指標，然後查詢此智慧型指標的介面類別型。 然後產生的指標就會封裝在這個 _com_ptr_t 物件內。 Release 呼叫 以遞減先前封裝指標的參考計數。 此常式會傳回 HRESULT，指出成功或失敗。

• GetActiveObject（ rclsid ） 附加至給定 CLSID 之物件的現有實例。

• GetActiveObject（ clsidString ） 附加至物件的現有實例，指定保留 （開頭為 「 { 」） 或 ProgID 的 Unicode 字串 CLSID 。

• GetActiveObject（ clsidStringA ） 附加至物件的現有實例，給定多位元組字元字串，該字串會保存 CLSID （開頭為 「 { 」） 或 ProgID 。 呼叫 MultiByteToWideChar ，假設字串位於 ANSI 字碼頁中，而不是 OEM 字碼頁。

END Microsoft 特定的

另請參閱

_com_ptr_t 類別