peerCollabGetContact 函式 (p2p.h)

PeerCollabGetContact 函式會根據聯繫人的對等名稱，取得對等聯繫人的資訊。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
  [in, optional]  PCWSTR        pwzPeerName,
  [out, optional] PPEER_CONTACT *ppContact
);

[in, optional] pwzPeerName

以零結束之 Unicode 字串的指標，其中包含要取得資訊的對等聯繫人名稱。

如果此參數為 NULL，則會傳回呼叫對等的 'Me' 連絡資訊。

[out, optional] ppContact

指向PEER_CONTACT結構的指標。它會接收包含 pwzPeerName 中所提供對等名稱之對等聯繫人資訊的PEER_CONTACT結構位址。當此參數為 NULL 時，此函式會傳回E_INVALIDARG。

在 PEER_CONTACT 結構的位址上呼叫 PeerFreeData，以釋放此數據。

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

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