IExternalConnection::ReleaseConnection メソッド (objidl.h)

  • [アーティクル]

オブジェクトの強力な外部接続の数をデクリメントします。

構文

DWORD ReleaseConnection(
  [in] DWORD extconn,
  [in] DWORD reserved,
  [in] BOOL  fLastReleaseCloses
);

パラメーター

[in] extconn

オブジェクトへの外部接続の種類。 このインターフェイスで現在サポートされている外部接続の唯一の種類は強力です。つまり、この外部接続が存在する限り、オブジェクトは存続する必要があります。 厳密な外部接続は、列挙 EXTCONN で定義されているEXTCONN_STRONG値によって表されます。

[in] reserved

接続に関する情報。 このパラメーターは、OLE で使用するために予約されています。 その値は 0 にできますが、必ずしもできません。 したがって、 ReleaseConnection の実装には、0 の値が返されるかどうかによって実行が決まるコード ブロックを含めないようにする必要があります。

[in] fLastReleaseCloses

解放される接続がオブジェクトの最後の外部ロックであるため、オブジェクトを閉じる必要がある場合、このパラメーターは TRUE です。 それ以外の場合、オブジェクトは、ユーザーまたは別のプロセスによって閉じられるまで開いたままにする必要があります。

戻り値

メソッドは、接続の数を返します。 この値は、デバッグ目的でのみ使用することを目的としています。

注釈

fLastReleaseCloses がTRUE の場合、ReleaseConnection を呼び出すと、オブジェクト自体がシャットダウンされます。 このメソッドの呼び出しは、コンテナー アプリケーションと同じプロセス空間で実行されている DLL オブジェクトが、サイレント更新後に閉じるタイミングを認識する唯一の方法です。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objidl.h (ObjIdl.h を含む)

こちらもご覧ください

IExternalConnection