PeerGroupCreate 関数 (p2p.h)

PeerGroupCreate 関数は、新しいピアグループを作成します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

[in] pProperties

ピアグループ名、招待の有効期間、プレゼンスの有効期間など、グループの特定の詳細を指定するPEER_GROUP_PROPERTIES構造体へのポインター。このパラメーターは必須です。

次のメンバーを設定する必要があります。

次のメンバーは設定できません。

残りのメンバーは省略可能です。

[out] phGroup

ピアグループへのハンドルポインターを返します。このハンドルをパラメーターとして呼び出された関数には、そのピアグループに対して対応するアクションが実行されます。このパラメーターは必須です。

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

リターンコード	説明
E_INVALIDARG	パラメーターの 1 つが無効です。
E_OUTOFMEMORY	指定した操作を実行するのに十分なメモリがありません。
PEER_E_CLOUD_NAME_AMBIGUOUS	pProperties で指定されたクラウドを一意に検出することはできません (複数のクラウドが指定された名前と一致します)。
PEER_E_INVALID_CLASSIFIER	pProperties で指定されたピアグループ分類子が無効です。
PEER_E_INVALID_PEER_NAME	pProperties でグループに指定されたピア名が無効です。
PEER_E_INVALID_PROPERTIES	pProperties で指定された 1 つ以上のピアグループプロパティが無効です。
PEER_E_NO_CLOUD	pProperties で指定されたクラウドが見つかりません。
PEER_E_NO_KEY_ACCESS	ID キーまたはグループキーへのアクセスは拒否されます。通常、これは、ユーザーまたはコンピューターキーを含むフォルダーに対して正しくないアクセス制御リスト (ACL) が原因で発生します。これは、ACL が手動でリセットされるときに発生する可能性があります。
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	指定されたパスワードがシステムパスワードの要件を満たしていません。
ERROR_DELETE_PENDING	グループ作成者として指定されたピア ID が削除されたか、削除処理中です。

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

PeerGroupConnect は、作成直後にグループ作成者によって呼び出される必要があります。これが行われなかった場合、招待を受けたユーザーは PeerGroupConnect を正常に呼び出しますが、リッスンできず、最終的に接続に失敗したイベントを受信します。

アプリケーションは、 PeerIdentityCreate、または ID 名文字列を返すその他のメソッドを呼び出して ID を取得します。この ID はグループの所有者として機能し、作成時のピアグループの初期メンバーです。

パスワードを使用するアプリケーションでは、 CryptoProtectMemory 関数と SecureZeroMemory 関数を呼び出して、パスワードを安全に処理することをお勧めします。

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