CoIsHandlerConnected 関数 (combaseapi.h)

リモート オブジェクトが対応するインプロセス オブジェクトに接続されているかどうかを判断します。

構文

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

パラメーター

[in] pUnk

リモート オブジェクトの制御する IUnknown インターフェイスへのポインター。

戻り値

オブジェクトがリモートでない場合、またはリモートで接続されている場合、戻り値は TRUE です。それ以外の場合は FALSE です。

注釈

CoIsHandlerConnected 関数は、リモート オブジェクトの状態を決定します。 これを使用して、リモート オブジェクトを解放するタイミングを決定できます。 リモート オブジェクトを指定するには、制御する IUnknown インターフェイス ( pUnk パラメーター) へのポインターを関数に指定します。 関数から返される TRUE の 値は、指定したオブジェクトがリモートではないこと、またはリモートであり、リモート ハンドラーに接続されていることを示します。 関数から返される FALSE の 値は、オブジェクトがリモートであるが、リモート ハンドラーに接続されていないことを示します。この場合、呼び出し元は オブジェクトを解放して応答する必要があります。

要件