PeerGroupConnect 関数 (p2p.h)

  • [アーティクル]

PeerGroupConnect 関数は、ピア グループの PNRP 検索を開始し、それに接続しようとします。 この関数が正常に呼び出されると、ピアはピア グループの他のメンバーと通信できます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

パラメーター

[in] hGroup

ピアが接続するピア グループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、PeerGroupJoin、または PeerGroupPasswordJoin 関数によって返されます。 このパラメーターは必須です。

戻り値

操作が成功した場合S_OKを返します。 それ以外の場合、関数は次の値を返します。

リターン コード 説明
PEER_E_INVALID_GROUP
 ピア グループへのハンドルが無効です。
 

暗号化固有のエラーは、 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

こちらもご覧ください

PeerGroupClose

PeerGroupJoin

PeerGroupOpen

PeerGroupPasswordJoin