PeerCollabEnumEndpoints 関数 (p2p.h)
PeerCollabEnumEndpoints 関数は、特定のピア連絡先に関連付けられているエンドポイントを含む列挙体にハンドルを返します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
[in] PCPEER_CONTACT pcContact,
[out] HPEERENUM *phPeerEnum
);
パラメーター
[in] pcContact
特定のピアの連絡先情報を含む PEER_CONTACT 構造体へのポインター。 このパラメーターは NULL にすることはできません。
[out] phPeerEnum
指定されたピア連絡先に関連付けられているエンドポイントの列挙セットのハンドルへのポインター。 このハンドルを PeerGetNextItem に渡して、列挙セット内の各項目を取得します。
戻り値
関数が成功した場合は、S_OKを返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
この操作をサポートするのに十分なメモリがありません。 |
|
引数の 1 つが無効です。 |
|
Windows ピア インフラストラクチャが初期化されていません。 関連する初期化関数を呼び出す必要があります。 |
|
この操作では、ユーザーがサインインする必要があります。 |
注釈
PeerCollabEnumEndpoints を呼び出す前に、PeerCollabUpdateContact を使用して連絡先レコードを更新することをお勧めします。 これを行わないと、E_INVALIDARGが返される可能性があります。
エンドポイントは、 fWatch が true に設定されている連絡先でのみ使用できます。 呼び出し元ピアの "Me" 連絡先が信頼できる連絡先として保存され、 WatcherPermissions が 許可 に設定されているエンドポイントのみが使用できます。 連絡先もインターネットにサインインしている必要があります。 連絡先がサインインしていない場合は、エラー E_INVALIDARG が返されます。
個々のピア エンドポイントを取得するには、返されたハンドルを PeerGetNextItem に渡します。 PEER_ENDPOINT構造体へのポインターの配列が返されます。 使用可能なエンドポイントがない場合は、空の配列が返されます。 列挙を閉じ、関連付けられているリソースを解放するには、このハンドルを PeerEndEnumeration に渡します。 列挙によって返される個々の項目は、 PeerFreeData を使用して解放する必要があります。
1 つの連絡先への接続の制限は 50 です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |