共用方式為

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 。 否則，函式會傳回下列其中一個值。

傳回碼 Description
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 中定義。

備註

此函式只能由系統管理員成功呼叫。

呼叫 PeerGroupEnumMembers 可取得成員 (PEER_CREDENTIAL_INFO) 的認證。 認證位於特定成員PEER_MEMBER結構的 pCredentialInfo 字段中。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll