PeerGroupConnect 関数 (p2p.h)
PeerGroupConnect 関数は、ピア グループの PNRP 検索を開始し、それに接続しようとします。 この関数が正常に呼び出されると、ピアはピア グループの他のメンバーと通信できます。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
パラメーター
[in] hGroup
ピアが接続するピア グループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、PeerGroupJoin、または PeerGroupPasswordJoin 関数によって返されます。 このパラメーターは必須です。
戻り値
操作が成功した場合S_OKを返します。 それ以外の場合、関数は次の値を返します。
| リターン コード | 説明 |
|---|---|
|
ピア グループへのハンドルが無効です。 |
暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。
注釈
アプリケーションは、この関数を呼び出す前にピア イベントに登録します。 関数呼び出しが失敗した場合は、PEER_GROUP_EVENT_CONNECTION_FAILED イベントが発生します。 それ以外の場合は、PEER_GROUP_EVENT_STATUS_CHANGED イベントが発生します。
PEER_GROUP_EVENT_CONNECTION_FAILED イベントは、グループ作成者が作成直後に PeerGroupConnect の呼び出しに失敗した場合にも発生します。 これが行われなかった場合、招待を受けたユーザーは PeerGroupConnect を正常に呼び出しますが、リッスンできず、最終的に接続に失敗したイベントを受信します。
参加しているマシン間でクロック スキューが発生した場合、 PeerGroupConnect の成功はスキューの重大度によって異なります。 参加の失敗のトラブルシューティングを行う場合は、マシン クロックが同期されていることを確認することで、この可能性を考慮する必要があります。
ピア グループに存在し、イベントを受信しても接続されていない状態を維持するには、 PeerGroupOpen 関数を使用します。
PeerGroupConnect のタイムアウト値がアプリケーションで指定されていない場合、エラーが発生すると、アプリケーションがハングします。 タイムアウト値は 30 秒をお勧めします。
PeerGroupConnect を呼び出す前に、グループは "切断状態" に存在します。 この間、グループを検出したり、接続を受信したりすることはできません。 グループをこの状態に戻すには、 PeerGroupClose 関数を呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |