PeerCollabSubscribeEndpointData 関数 (p2p.h)
PeerCollabSubscribeEndpointData 関数は、使用可能なエンドポイントへのサブスクリプションを作成します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
[in] const PCPEER_ENDPOINT pcEndpoint
);
パラメーター
[in] pcEndpoint
プレゼンス 情報の取得 に使用されるピア エンドポイントを含むPEER_ENDPOINT構造体へのポインター。
戻り値
関数が成功した場合は、S_OKまたはPEER_S_SUBSCRIPTION_EXISTSを返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
この操作をサポートするのに十分なメモリがありません。 |
|
引数の 1 つが無効です。 |
|
Windows ピア インフラストラクチャが初期化されていません。 関連する初期化関数を呼び出す必要があります。 |
注釈
PeerCollabSubscribeEndpointData は非同期呼び出しです。つまり、エンドポイントをサブスクライブするプロセスは開始されましたが、この呼び出しが返されたときに必ずしも完了したわけではありません。 アプリケーションは、PEER_EVENT_REQUEST_STATUS_CHANGEDがサブスクリプション要求の結果を取得するまで待機する必要があります。
この関数は 30 秒でタイムアウトします。
PeerCollabSubscribeEndpointData は、同じエンドポイントに対して異なるアプリケーションから複数回呼び出すことができます。 各呼び出しは参照カウントされます。最後の参照が解放された場合にのみ、ピアがサブスクライブ解除されます。 参照を解放するには、 PeerCollabUnsubscribeEndpointData を呼び出します。
PeerCollabUnsubscribeEndpointData を呼び出さずにアプリケーションが終了すると、そのアプリケーションのすべての参照が自動的に解放されます。
PeerCollabGetPresenceInfo、PeerCollabEnumApplications、PeerCollabEnumObjects、PeerCollabQueryContactData API を正常に呼び出すには、アプリケーションで最初に PeerCollabSubscribeEndpointData を呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |