PeerGroupOpen 関数 (p2p.h)

PeerGroupOpen 関数は、ピアが作成または参加したピア グループを開きます。 ピア グループを開いた後、ピアはイベント通知を登録できます。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

パラメーター

[in] pwzIdentity

ピアがグループを開くために使用する ID を含む Unicode 文字列へのポインター。 このパラメーターは必須です。

[in] pwzGroupPeerName

ピア グループのピア名を含む Unicode 文字列へのポインター。 このパラメーターは必須です。

[in] pwzCloud

ピア グループが配置されている PNRP クラウドの名前を含む Unicode 文字列へのポインター。 値が NULL の場合は、ピア グループのプロパティで指定されたクラウドが使用されます。

[out] phGroup

ピア グループのハンドルへのポインター。 この値が NULL の場合、開いている操作は失敗します。 このパラメーターは必須です。

戻り値

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

リターン コード 説明
E_INVALIDARG
パラメーターの 1 つが無効です。
E_OUTOFMEMORY
操作を完了するのに十分なメモリがありません。
PEER_E_CLOUD_NAME_AMBIGUOUS
pwzCloud で指定されたクラウドは、指定された名前と一致する複数のクラウドなど、一意に検出できません。
PEER_E_NO_CLOUD
pwzCloud で指定されたクラウドが見つかりません。
PEER_E_NO_KEY_ACCESS
ピア ID またはピア グループ キーへのアクセスは拒否されます。 通常、これは、ユーザーまたはコンピューター キーを含むフォルダーに対して正しくないアクセス制御リスト (ACL) が原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。
 

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

解説

複数のアプリケーションで同じグループを同時に開くことができます。 どのアプリケーションでも、後で PeerGroupConnect を呼び出さずにグループを開くことができます。 これらのアプリケーションはオフラインと見なされます。 ただし、2 つ目のアプリケーションはピアを開いてグループに接続できます。つまり、アプリケーションはいつでも接続する準備ができている必要があります。

要件

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

関連項目

PeerGroupClose

PeerGroupConnect

PeerGroupCreate

PeerGroupJoin