共用方式為

peerIdentityExport 函式 (p2p.h)

  • 發行項

PeerIdentityExport 函式可讓用戶導出一個對等識別。 然後，使用者可以將對等身分識別傳輸至不同的計算機。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityExport(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzExportXML
);

參數

[in] pwzIdentity

指定要導出的對等識別。 這個參數是必要的，而且沒有預設值。

[in] pwzPassword

指定要用來加密對等識別的密碼。 此參數不可為 NULL。 此密碼也必須用來匯入對等識別，否則匯入作業會失敗。

[out] ppwzExportXML

接收 XML 格式匯出對等識別的指標。 如果匯出作業成功，應用程式必須藉由呼叫PeerFreeData來釋放ppwzExportXML。

傳回值

如果函數調用成功，傳回值會 S_OK。 否則，它會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_NO_KEY_ACCESS
 拒絕對等身分識別或對等群組密鑰的存取。 這通常是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 已手動重設時，就會發生這種情況。
PEER_E_NOT_FOUND
指定的對等識別不存在。

備註

不會匯出點對點群組成員資格認證。 只會匯出一個對等識別。 導出的對等識別可以使用 PeerIdentityImport 在另一部電腦上匯入。

匯出對等身分識別並不會將它從本機 ccmputer 中移除，它會製作它的複本。 此復本可用來備份和還原對等身分識別。

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

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

規格需求

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

另請參閱

PEER_DATA

PeerFreeData

PeerIdentityImport