PeerGraphUpdateRecord-Funktion (p2p.h)

Artikel
08/25/2023

Die Funktion PeerGraphUpdateRecord aktualisiert einen Datensatz im Peerdiagramm und flutet den Datensatz dann an jeden Knoten im Peerdiagramm.

Syntax

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

Parameter

[in] hGraph

Handle mit dem Peerdiagramm.

[in] pRecord

Zeiger auf eine PEER_RECORD-Struktur , die die neuen Daten für den Datensatz enthält.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
PEER_E_GRAPH_NOT_READY	Das Peerdiagramm wurde nie synchronisiert. Datensätze können erst aktualisiert werden, wenn das Diagramm synchronisiert wurde.
PEER_E_INVALID_GRAPH	Das Handle für das Peerdiagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Das Peerdiagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.
PEER_E_RECORD_NOT_FOUND	Der angegebene Datensatz wurde nicht gefunden.

Hinweise

Die folgenden Elemente der PEER_RECORD-Struktur können geändert werden:

pwzAttributes
ftExpiration : Der Ablauf kann nur erhöht werden
data
pwzLastModified : Standardmäßig ausgefüllt, wenn kein Wert angegeben wird

Beispiele

Dieser Codeausschnitt zeigt, wie ein Datensatz aktualisiert wird.

// 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.
    }

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2PGraph.lib
DLL	P2PGraph.dll

Weitere Informationen

PEER_RECORD

Freigeben über