共用方式為

peerIdentityImport 函式 (p2p.h)

  • 發行項

PeerIdentityImport 函式會匯入一個對等識別。 如果計算機上存在對等身分識別，則會傳回 PEER_E_ALREADY_EXISTS 。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityImport(
  [in]  PCWSTR pwzImportXML,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzIdentity
);

參數

[in] pwzImportXML

要匯入的 XML 格式對等身分識別指標，由 PeerIdentityExport 傳回。 此二進位數據必須符合匯出的數據位元組 for-byte。 XML 必須維持有效的 XML，且沒有額外的字元。

[in] pwzPassword

指定要用來取消對等身分識別的密碼。 密碼必須與提供給 PeerIdentityExport 的密碼相同。 此參數不可為 NULL。

[out] ppwzIdentity

字串的指標，表示匯入的對等識別。 如果匯入作業成功，應用程式必須呼叫 PeerFreeData 來釋放 ppwzIdentity。

傳回值

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

傳回碼 Description
E_INVALIDARG
 其中一個參數無效，或 ppwzImportXML 中的 XML 數據遭到竄改。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_ALREADY_EXISTS
 此計算機上已經存在對等身分識別。
PEER_E_NO_KEY_ACCESS
 拒絕對等身分識別或對等群組密鑰的存取。 一般而言，這是由包含使用者或計算機密鑰的資料夾 (ACL) 不正確的訪問控制清單所造成。 當 ACL 已手動重設時，就會發生這種情況。

備註

PeerIdentityImport 所使用的 XML 片段如下所示：

<PEERIDENTITYEXPORT VERSION="1.0">
   <IDENTITY>
     <!-- UTF-8 encoded peer name of the identity -->
   </IDENTITY>
   <IDENTITYDATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </IDENTTYDATA>
</PEERIDENTITYEXPORT>

規格需求

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

另請參閱

PEER_DATA

PeerFreeData

PeerIdentityExport