Funzione PeerGraphUpdateRecord (p2p.h)

Articolo
08/25/2023

La funzione PeerGraphUpdateRecord aggiorna un record nel grafico peer e quindi esegue l'inondazione del record a ogni nodo nel grafico peer.

Sintassi

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

Parametri

[in] hGraph

Gestire il grafico peer.

[in] pRecord

Puntatore a una struttura PEER_RECORD che contiene i nuovi dati per il record.

Valore restituito

Se la chiamata alla funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
PEER_E_GRAPH_NOT_READY	Il grafico peer non è mai stato sincronizzato. I record non possono essere aggiornati fino a quando il grafico non è stato sincronizzato.
PEER_E_INVALID_GRAPH	L'handle al grafico peer non è valido.
PEER_E_NOT_INITIALIZED	Il grafico peer deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.
PEER_E_RECORD_NOT_FOUND	Il record specificato non è stato trovato.

Commenti

È possibile modificare i membri seguenti della struttura PEER_RECORD :

pwzAttributes
ftExpiration : la scadenza può essere aumentata solo
data
pwzLastModified - compilato per impostazione predefinita se non viene specificato alcun valore

Esempio

Questo frammento di codice mostra come aggiornare un record.

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

Requisiti


Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll

Vedi anche

PEER_RECORD

Condividi tramite