PeerGroupJoin 関数 (p2p.h)
PeerGroupJoin 関数は、PeerGroupConnect または PeerGroupConnectByAddress を呼び出す前に、既存のピア グループに参加するための招待を含むピアを準備します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzInvitation,
[in] PCWSTR pwzCloud,
[out] HGROUP *phGroup
);
パラメーター
[in] pwzIdentity
指定したピア グループを開く ID を含む Unicode 文字列へのポインター。 このパラメーターが NULL の場合、実装では PeerIdentityGetDefault から取得した ID が使用されます。
[in] pwzInvitation
別のピアによって付与された XML 招待を含む Unicode 文字列へのポインター。 招待するピアが PeerGroupCreateInvitation または PeerGroupIssueCredentials を呼び出すと、招待が作成されます。 この招待に関する具体的な詳細は、PeerGroupParseInvitation を呼び出すことによって、PEER_INVITATION_INFO構造体として取得できます。 このパラメーターは必須です。
[in] pwzCloud
グループが配置されている PNRP クラウドの名前を含む Unicode 文字列へのポインター。 既定値は NULL です。これは、招待で指定されたクラウドを使用する必要があることを示します。
[out] phGroup
ピア グループのハンドルへのポインター。 グループとの通信を開始するには、 PeerGroupConnect を呼び出します。 このパラメーターは必須です。
戻り値
操作 が成功した場合S_OK を返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
パラメーターの 1 つが無効です。 |
|
操作を完了するのに十分なメモリがありません。 |
|
クラウドを一意に検出することはできません。たとえば、指定された名前と一致するクラウドが複数ある場合などです。 |
|
pwzIdentity で指定されたピア ID が無効です。 |
|
招待で指定された有効期間が無効です。 指定した期間の有効期限が切れているか、招待がまだ有効ではありません (つまり、指定した ValidityStart の日付/時刻にまだ達していません)。 このエラーが返される原因の 1 つは、グループに参加しているコンピューターまたは招待を発行したコンピューターでシステム クロックが正しく設定されていないことです。 |
|
招待は信頼されていません。 これは、招待の変更、エラー、または有効期限が原因である可能性があります。 |
|
クラウドを見つけられない。 |
|
招待は、ピア インフラストラクチャの現在のバージョンではサポートされていません。 |
|
ピア ID またはピア グループ キーへのアクセスは拒否されます。 通常、これは、ユーザーまたはコンピューター キーを含むフォルダーに対して正しくないアクセス制御リスト (ACL) が原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。 |
暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。
要件
| サポートされている最小のクライアント | WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |