共用方式為

PeerIdentityCreate 函式 (p2p.h)

  • 發行項

PeerIdentityCreate 函式會建立新的對等識別，並傳回其名稱。 對等識別的名稱必須傳入所有後續呼叫，以代表對等識別運作的對等 Identity Manager、對等群組或 PNRP 函式。 對等識別名稱會指定正在使用哪一個對等識別。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityCreate(
  [in]  PCWSTR     pwzClassifier,
  [in]  PCWSTR     pwzFriendlyName,
  [in]  HCRYPTPROV hCryptProv,
  [out] PWSTR      *ppwzIdentity
);

參數

[in] pwzClassifier

指定要附加至已發佈對等識別名稱的分類器。 此字串是 Unicode 字串，可以是 NULL。 此字串長度只能是 150 個字元，包括 NULL 終止符。

[in] pwzFriendlyName

指定對等識別的易記名稱。 這是 Unicode 字串，可以是 NULL。 此字串長度只能是 256 個字元，包括 NULL 終止符。 如果 pwzFriendlyName 為 NULL，則身分識別的名稱是易記名稱。 易記名稱是選擇性的，而且不一定是唯一的。

[in] hCryptProv

處理密碼編譯服務提供者 (CSP) ，其中包含長度至少 1024 位的AT_KEYEXCHANGE密鑰組。 此金鑰組會作為新對等身分識別的基礎。 如果 hCryptProv 為零 (0) ，則會為對等身分識別產生新的密鑰組。

注意Identity Manager API 不支援具有使用者保護金鑰的 CSP。 如果使用具有使用者保護金鑰的 CSP，PeerIdentityCreate 會傳回E_INVALIDARG。
 

[out] ppwzIdentity

接收所建立對等身分識別名稱的指標。 此名稱必須用於所有後續對等 Identity Manager、對等群組或代表對等身分識別運作的 PNRP 函式呼叫。 如果無法建立對等識別，則傳回 NULL 。

傳回值

如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。

傳回碼 Description
ERROR_INVALID_HANDLE
 hCryptProv 所指定密鑰的句柄無效。
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_ALREADY_EXISTS
對等身分識別已經存在。 只有在根據指定的索引鍵和分類器存在的對等身分識別存在時才會發生。
PEER_E_NO_KEY_ACCESS
 拒絕對等身分識別或對等群組密鑰的存取。 一般而言，這是由包含使用者或計算機密鑰的資料夾 (ACL) 不正確的訪問控制清單所造成。 當 ACL 已手動重設時，就會發生這種情況。
PEER_E_TOO_MANY_IDENTITIES
 無法建立對等識別，因為有太多對等識別。

備註

密鑰組和分類器是用來產生新對等識別的對等名稱。 建立對等身分識別之後，它會自動儲存在磁碟上。

應該使用 PeerFreeData 釋放身分識別的名稱。 這不會刪除對等身分識別。 若要刪除身分識別，請使用 PeerIdentityDelete 函式。

如果 hCryptProv 不是 NULL，則可以在呼叫傳回之後使用 CryptReleaseContext 來釋放它。

規格需求

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

另請參閱

CryptReleaseContext

PeerFreeData

PeerIdentityDelete