_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
    CLSID ({ 「と」で始まる) または ProgID を保持する Unicode 文字列。

  • clsidStringA
    マルチバイト文字列CLSID ({ 「と」で始まる) または ProgID を保持する ANSI コード ページを使用します。

解説

OLE に登録されこのスマート ポインターのインターフェイス型に対してクエリを実行するオブジェクトへのポインターを取得するためにこれらのメンバー関数の呼び出しは GetActiveObject。ポインターが発生 _com_ptr_t でこのオブジェクトの中にカプセル化します。 解放 は以前にカプセル化ポインターの参照カウントをデクリメントするために呼び出されます。このルーチンは成功または失敗を示すために HRESULT を返します。

  • (GetActiveObject rclsid**)** は   CLSID のオブジェクトの既存のインスタンスにアタッチします。

  • CLSID  ({ 「と」で始まる) または ProgID を保持する Unicode のオブジェクトの既存のインスタンスへの (GetActiveObject clsidString**)** の文字列に対してはアタッチします。

  • (GetActiveObject clsidStringA**)** は   CLSID ({ 「と」で始まる) または ProgID を保持するマルチバイト文字列のオブジェクトの既存のインスタンスにアタッチします。MultiByteToWideChar を呼び出し文字列はOEM のコード ページではなく ANSI コード ページに使用する。

終了 Microsoft 固有の仕様→

参照

関連項目

_com_ptr_t クラス