PeerCollabParseContact 函式 (p2p.h)

PeerCollabParseContact 函式會將包含聯繫人 XML 數據的 Unicode 字串緩衝區剖析成PEER_CONTACT數據結構。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabParseContact(
  [in]  PCWSTR        pwzContactData,
  [out] PPEER_CONTACT *ppContact
);

[in] pwzContactData

零終止 Unicode 字串緩衝區的指標，其中包含 PeerCollabQueryContactData 或 PeerCollabExportContact 等函式所傳回的 XML 聯繫人數據。

[out] ppContact

包含從 pwzContactData 剖析的對等聯繫人資訊之PEER_CONTACT結構的地址指標。藉由呼叫 PeerFreeData 釋放配置的記憶體。

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

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