共用方式為

peerIdentityGetXML 函式 (p2p.h)

  • 發行項

PeerIdentityGetXML函式會傳回對等識別的描述，然後可以傳遞至協力廠商，並用來邀請對等身分識別加入對等群組。 這項資訊會以 XML 片段的形式傳回。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

參數

[in] pwzIdentity

指定要擷取對等識別資訊的對等識別。 當此參數傳遞為 Null時，對等基礎結構會為使用者產生「預設」身分識別。

[out] ppwzIdentityXML

包含 XML 片段之 Unicode 字串指標的指標。 不再需要 ppwzIdentityXML 時，應用程式會負責呼叫 PeerFreeData來釋放此字串。

傳回值

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

傳回碼 描述
E_HANDLE
 身分識別的控制碼無效。
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。

備註

傳回的 XML 片段具有下列結構：

<PEERIDENTITYINFO VERSION="1.0">
     <IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
          Base 64 encoded certificate.
     </IDC>
</PEERIDENTITYINFO>

建立加入群組的邀請時，會使用此 XML 片段。

應用程式不允許在 PEERIDENTITYINFO 標籤內新增標記，或以任何方式修改此 XML 片段。 允許應用程式將此 XML 片段併入其他 XML 檔中，但必須先移除所有應用程式特定 XML，再將此片段傳遞至 PeerGroupCreateInvitation。

需求

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

另請參閱

PEER_CONTACT

PeerFreeData

PeerGroupCreateInvitation