PeerGroupIssueCredentials 函数 (p2p.h)

  • 项目

PeerGroupIssueCredentials 函数向特定标识颁发凭据（包括 GMC），并选择性地返回邀请的对等方可用于加入对等组的邀请 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

指定要向其颁发凭据的对等方的标识。 此参数是必需的。

[in] pCredentialInfo

PEER_CREDENTIAL_INFO 结构，其中包含有关其标识在 pwzSubjectIdentity 中指定的对等方的凭据的信息。 如果此参数为 NULL，则改用存储在对等数据库中的信息。 此参数是可选的。

如果提供了此参数，则会忽略 PEER_CREDENTIAL_INFO 中的以下字段：

  • pwzIssuerPeerName
  • pwzIssuerFriendlyName

[in] dwFlags

指定一组标志，用于描述颁发凭据时执行的操作。 如果此参数设置为 0 (零) ，则 凭据将在 ppwzInvitation 中返回。 此参数是可选的。

值 含义
PEER_GROUP_STORE_CREDENTIALS
 在组数据库中发布使用者标识的新创建的 GMC。 使用者会自动选取 GMC。 如果未设置此标志，则凭据必须由其他应用程序（如电子邮件）获取。

[out] ppwzInvitation

指向函数调用返回的邀请 XML 字符串的指针。 此邀请以带外形式传递给在调用 PeerGroupJoin 时使用它的受邀对等方。 此参数可选。

返回值

如果操作成功，则返回 S_OK 。 否则，函数将返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 没有足够的内存可用于完成操作。
PEER_E_IDENTITY_DELETED
 创建凭据的标识已被删除。
PEER_E_IDENTITY_NOT_FOUND
 无法在组数据库中找到标识， pCredentialInfo 为 NULL。
PEER_E_NO_KEY_ACCESS
 拒绝访问标识或组密钥。 通常，这是由于包含用户或计算机密钥的文件夹的 ACL) (访问控制列表不正确造成的。 当 ACL 已手动重置时，可能会发生这种情况。
 

可以从 Microsoft RSA 基本提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

注解

此函数只能由管理员成功调用。

成员 (PEER_CREDENTIAL_INFO) 的凭据是通过调用 PeerGroupEnumMembers 获取的。 凭据位于特定成员PEER_MEMBER结构的 pCredentialInfo 字段中。

要求

要求 值
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll