peerCollabExportContact 函式 (p2p.h)

PeerCollabExportContact 函式會將與對等名稱相關聯的聯繫人數據導出至字串緩衝區。緩衝區包含 XML 格式的聯繫人數據。

PeerCollabAddContact 函式允許其他對等使用此 XML 字串。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

[in, optional] pwzPeerName

以零結尾 Unicode 字串的指標，其中包含要導出的對等聯繫人名稱。

如果此參數為 NULL，則會匯出呼叫對等的「Me」連絡資訊。

[out, optional] ppwzContactData

零終止字串緩衝區的指標，其中包含對等聯繫人 XML 數據，其中對等名稱符合 pwzPeerName 中提供的字串。

呼叫 PeerFreeData 可以釋放這裡傳回的記憶體。

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

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援這項作業。
E_INVALIDARG	其中一個自變數無效。
PEER_E_NOT_INITIALIZED	Windows 對等基礎結構未初始化。需要呼叫相關的初始化函式。
PEER_E_NOT_SIGNED_IN	其中一個自變數無效。