peerCollabQueryContactData 函式 (p2p.h)

PeerCollabQueryContactData 函式會擷取所提供對等端點的連絡資訊。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

參數

[in, optional] pcEndpoint

PEER_ENDPOINT 結構的指標，其中包含要取得連絡資訊的對等端點。

如果此參數設定為 NULL，則會取得目前對等端點的連絡資訊。

[out] ppwzContactData

以零結束的 Unicode 字串緩衝區指標，其中包含 pcEndpoint 中提供之端點的連絡數據。 呼叫 PeerFreeData 以釋放數據。

傳回值

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

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援這項作業。
E_INVALIDARG	其中一個自變數無效。
PEER_E_NOT_FOUND	要求的聯繫人數據不存在。 請先嘗試呼叫 PeerCollabRefreshEndpointData ，再嘗試另一次。

備註

若要成功擷取端點的連絡數據，必須發生下列其中一項：

• 先前必須藉由呼叫 PeerCollabEnumEndpoints 來取得端點。
• 本機對等必須藉由呼叫 PeerCollabSubscribeEndpointData 來訂閱端點。
• 端點數據必須藉由成功呼叫 PeerCollabRefreshEndpointData 來重新整理。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll

另請參閱

PEER_ENDPOINT

對等共同作業 API 函式