peerGraphAddRecord 函式 (p2p.h)

PeerGraphAddRecord 函式會將新記錄新增至對等圖形。使用此函式新增的記錄會傳送至對等圖形中的每個節點。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

[in] hGraph

對等圖形的句柄。

[in] pRecord

要加入之記錄的指標。

[out] pRecordId

指定可唯一識別對等圖表中記錄的記錄標識碼。

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

傳回碼	Description
E_ACCESSDENIED	無法存取對等圖形。
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_GRAPH_NOT_READY	圖表未同步處理。在同步處理對等圖形之前，無法新增記錄。
PEER_E_GRAPH_SHUTTING_DOWN	已呼叫PeerGraphClose 。
PEER_E_INVALID_ATTRIBUTES	指定的屬性不符合架構。
PEER_E_INVALID_GRAPH	對等圖形的句柄無效。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	記錄超過對等圖形允許的大小上限。
PEER_E_NOT_INITIALIZED	使用這個函式之前，必須先使用對PeerGraphStartup的呼叫來初始化圖形。

PEER_RECORD 結構的下列成員必須包含有效的值：

dwSize。
類型。
ftExpiration - 必須晚於目前的圖形時間，而且必須使用 PeerGraphUniversalTimeToPeerTime 在對等時間中指定。

PEER_RECORD 結構的下列 成員是選擇性的。如果您的應用程式未使用它們，請將它們設定為 NULL ：

如果下列任何成員為 NULL，對等圖形 API 會執行指定的預設行為：

無法指定下列成員;使用的任何值會由對等圖形基礎結構覆寫：

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2PGraph.lib
Dll	P2PGraph.dll