共用方式為

peerCollabAddContact 函式 (p2p.h)

  • 發行項

PeerCollabAddContact函式會將連絡人新增至對等的連絡人清單。

語法

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

參數

[in] pwzContactData

零終止 Unicode 字串緩衝區的指標，其中包含已加入連絡人清單之對等的連絡人資料。 您可以傳遞端點的對等名稱來取得此字串緩衝區，以新增為 PeerCollabQueryContactData的連絡人，或透過頻外機制取得。

若要在頻外傳送自己的連絡人資料，對等可以使用Null對等名稱呼叫PeerCollabExportContact。 此函式會以 XML 格式傳回連絡人資料。

[out, optional] ppContact

指向PEER_CONTACT結構的指標。 此參數會接收包含pwzContactData中所提供連絡人之對等連絡資訊的PEER_CONTACT結構位址。 此參數可以是 Null。

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

傳回值

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

傳回碼 描述
E_OUTOFMEMORY
 記憶體不足，無法支援這項作業。
E_INVALIDARG
 其中一個引數無效。

需求

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

另請參閱

PEER_CONTACT

對等共同作業 API 函式

PeerCollabExportContact

PeerCollabQueryContactData