次の方法で共有

PeerGroupIssueCredentials 関数 (p2p.h)

  • [アーティクル]

PeerGroupIssueCredentials 関数は、GMC を含む資格情報を特定の ID に発行し、必要に応じて、招待されたピアがピア グループへの参加に使用できる招待 XML 文字列を返します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

パラメーター

[in] hGroup

ピアが潜在的な招待されたピアに資格情報を発行するピア グループに処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。

[in] pwzSubjectIdentity

資格情報を発行するピアの ID を指定します。 このパラメーターは必須です。

[in] pCredentialInfo

PEER_CREDENTIAL_INFOpwzSubjectIdentity で ID が指定されているピアの資格情報に関する情報を含む構造体です。 このパラメーターが NULL の場合は、ピア データベースに格納されている情報が代わりに使用されます。 このパラメーターは省略可能です。

このパラメーターを指定すると、 PEER_CREDENTIAL_INFO 内の次のフィールドは無視されます。

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

資格情報が発行されたときに実行されるアクションを記述するために使用されるフラグのセットを指定します。 このパラメーターが 0 (ゼロ) に設定されている場合、資格情報は ppwzInvitation で返されます。 このパラメーターは省略可能です。

値 意味
PEER_GROUP_STORE_CREDENTIALS
 サブジェクト ID の新しく作成された GMC をグループ データベースに発行します。 GMC は、件名によって自動的に取得されます。 このフラグが設定されていない場合は、電子メールなどの別のアプリケーションによって資格情報を取得する必要があります。

[out] ppwzInvitation

関数呼び出しによって返される招待 XML 文字列へのポインター。 この招待は、 PeerGroupJoin への呼び出しで使用する招待されたピアに帯域外で渡されます。 このパラメーターは省略できます。

戻り値

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

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 操作を完了するのに十分なメモリがありません。
PEER_E_IDENTITY_DELETED
 資格情報を作成する ID が削除されました。
PEER_E_IDENTITY_NOT_FOUND
 グループ データベースに ID が見つかり、 pCredentialInfo が NULL です。
PEER_E_NO_KEY_ACCESS
 ID キーまたはグループ キーへのアクセスは拒否されます。 通常、これは、ユーザーまたはコンピューター のキーを含むフォルダーのアクセス制御リスト (ACL) が正しくないことが原因で発生します。 これは、ACL が手動でリセットされた場合に発生する可能性があります。
 

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

注釈

この関数は、管理者のみが正常に呼び出すことができます。

メンバー (PEER_CREDENTIAL_INFO) の資格情報は、 PeerGroupEnumMembers を呼び出すことによって取得されます。 資格情報は、特定のメンバーのPEER_MEMBER構造の pCredentialInfo フィールドにあります。

要件

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