次の方法で共有

PeerGroupPasswordJoin 関数 (p2p.h)

  • [アーティクル]

PeerGroupPasswordJoin 関数は、PeerGroupConnect または PeerGroupConnectByAddress を呼び出す前に、パスワードで保護されたピア グループに参加するための招待と正しいパスワードを使用してピアを準備します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

パラメーター

[in] pwzIdentity

指定したピア グループを開く ID を含む Unicode 文字列へのポインター。 このパラメーターが NULL の場合、実装では PeerIdentityGetDefault から取得した ID が使用されます。

[in] pwzInvitation

別のピアによって付与された XML 招待を含む Unicode 文字列へのポインター。 招待元のピアが PeerGroupCreatePasswordInvitation を呼び出すと、パスワードを含む招待が作成されます。 グループ作成者によって設定されたパスワードなど、この招待に関する具体的な詳細は、PeerGroupParseInvitation を呼び出すことによって、PEER_INVITATION_INFO構造として取得できます。 このパラメーターは必須です。

[in] pwzPassword

ピア グループの検証と参加に必要なパスワードを含む、0 で終わる Unicode 文字列へのポインター。 このパスワードは、招待で指定されたパスワードと一致している必要があります。 このパラメーターは必須です。

[in] pwzCloud

グループが配置されている PNRP クラウドの名前を含む Unicode 文字列へのポインター。 既定値は NULL です。これは、招待で指定されたクラウドを使用する必要があることを示します。

[out] phGroup

ピア グループのハンドルへのポインター。 グループとの通信を開始するには、 PeerGroupConnect を呼び出します。 このパラメーターは必須です。

戻り値

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

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 操作を完了するのに十分なメモリがありません。
PEER_E_CLOUD_NAME_AMBIGUOUS
 クラウドを一意に検出することはできません。たとえば、指定された名前と一致するクラウドが複数ある場合などです。
PEER_E_INVALID_PEER_NAME
 pwzIdentity で指定されたピア ID が無効です。
PEER_E_INVITATION_NOT_TRUSTED
 招待はピアによって信頼されていません。 変更されたか、エラーが含まれています。
PEER_E_NO_CLOUD
 クラウドを見つけられない。
PEER_E_UNSUPPORTED_VERSION
 招待は、ピア インフラストラクチャの現在のバージョンではサポートされていません。
PEER_E_NO_KEY_ACCESS
 ピア ID またはピア グループ キーへのアクセスは拒否されます。 通常、これは、ユーザーまたはコンピューター キーを含むフォルダーに対して正しくないアクセス制御リスト (ACL) が原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。
PEER_S_ALREADY_A_MEMBER
 ローカル ピアは、パスワードに基づいてグループに複数回参加しようとしました。
 

暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返される場合があります。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

注釈

参加しているマシン間でクロック スキューが発生した場合でも、最初の PeerGroupPasswordJoin 関数は引き続き成功しますが、 PeerGroupConnect の次の呼び出しでは、スキューの重大度に応じて結合に失敗する可能性があります。

要件

要件 値
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2P.lib
[DLL] P2P.dll

こちらもご覧ください

PeerGroupConnect

PeerGroupConnectByAddress