共用方式為

PeerGraphUpdateRecord 函式 (p2p.h)

  • 發行項

PeerGraphUpdateRecord函式會更新對等圖形中的記錄，然後將記錄溢入對等圖形中的每個節點。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphUpdateRecord(
  [in] HGRAPH       hGraph,
  [in] PPEER_RECORD pRecord
);

參數

[in] hGraph

對等圖形的控制碼。

[in] pRecord

包含記錄新資料的 PEER_RECORD 結構的指標。

傳回值

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

傳回碼 描述
E_INVALIDARG
 其中一個參數無效。
PEER_E_GRAPH_NOT_READY
 對等圖形從未同步處理過。 在圖表同步處理之前，無法更新記錄。
PEER_E_INVALID_GRAPH
 對等圖形的控制碼無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先呼叫 PeerGraphStartup 來初始化對等圖形。
PEER_E_RECORD_NOT_FOUND
 找不到指定的記錄。

備註

您可以修改 PEER_RECORD 結構的下列成員：

  • pwzAttributes
  • ftExpiration - 只能增加到期日
  • data
  • pwzLastModified - 如果未提供任何值，預設會填入

範例

此程式碼片段示範如何更新記錄。

// dwFlags is updated to automatically refresh the record if it is about to expire.
    record.dwFlags = PEER_RECORD_FLAG_AUTOREFRESH;
    // The record data is updated with the string contained in pwzUserData.
    record.data.cbData = (ULONG) wcslen(pwzUserData) * sizeof(WCHAR);
    record.data.pbData = (PBYTE) pwzUserData;

    HRESULT hr = PeerGraphUpdateRecord(hGraph, &record;);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

需求

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

另請參閱

PEER_RECORD