PeerGroupCreateInvitation 関数 (p2p.h)
PeerGroupCreateInvitation 関数は、指定されたピアがグループに参加するために使用できる XML 文字列を返します。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
[in] HGROUP hGroup,
[in] PCWSTR pwzIdentityInfo,
[in] FILETIME *pftExpiration,
[in] ULONG cRoles,
[in] const GUID *pRoles,
[out] PWSTR *ppwzInvitation
);
パラメーター
[in] hGroup
この招待が発行されるピア グループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。
[in] pwzIdentityInfo
ピア ID を持つ PeerIdentityGetXML への以前の呼び出しによって返された XML BLOB (GMC を含む) を含む Unicode 文字列へのポインター。 または、このパラメーターには、ピア連絡先の招待を生成するために、PEER_CONTACTに含まれるピア情報を使用して PeerIdentityGetXML によって生成された XML BLOB へのポインターを含めることができます。
[in] pftExpiration
招待の有効期限が切れる特定の日付と時刻を含む UTC FILETIME 構造体を指定します。 この値は、発行元ピアの残りの有効期間を超えることはできません。 このパラメーターが NULL の場合、招待の有効期間は可能な最大値 (ピアの残りの有効期間) に設定されます。
[in] cRoles
pRoleInfo のロールの数を指定します。
[in] pRoles
使用可能なロールの組み合わせセットを指定する GUID のリストへのポインター。 使用可能なロールは次のとおりです。
| 値 | 意味 |
|---|---|
|
このロールでは、招待を発行したり、資格情報を発行したり、他の管理者の GMC を更新したり、ピア グループのメンバーとして動作したりできます。 |
|
このロールは、レコードをグループ データベースに発行できます。 |
[out] ppwzInvitation
発行者からの招待を含む Unicode 文字列へのポインター。 この招待は、指定されたピア グループに参加するために、受信者が PeerGroupJoin に渡すことができます。 招待の詳細を PEER_INVITATION_INFO 構造体として返すには、この文字列を PeerGroupParseInvitation に渡します。 このデータを解放するには、このポインターを PeerFreeData に渡します。
戻り値
操作が成功した場合は、S_OKを返します。それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
パラメーターの 1 つが無効です。 |
|
指定した操作を実行するのに十分なメモリがありません。 |
|
ピア グループは、レコードを追加できる状態ではありません。 たとえば、 PeerGroupJoin が呼び出されますが、グループ データベースとの同期は完了していません。 |
|
GMC チェーンは、24 人の管理者またはメンバーを超えています。 GMC チェーンの詳細については、 グループ セキュリティのしくみ に関するドキュメントを参照してください。 |
|
pwzIdentityInfo として渡されるデータは、削除された ID 用であり、無効になっています。 |
|
このメソッドを呼び出したピアは管理者ではありません。 |
|
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 |