Compartir a través de

Función PeerGraphUpdateRecord (p2p.h)

  • Artículo

La función PeerGraphUpdateRecord actualiza un registro en el gráfico del mismo nivel y, a continuación, inunda el registro en cada nodo del gráfico del mismo nivel.

Sintaxis

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

Parámetros

[in] hGraph

Identificador del gráfico del mismo nivel.

[in] pRecord

Puntero a una estructura de PEER_RECORD que contiene los nuevos datos del registro.

Valor devuelto

Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto Descripción
E_INVALIDARG
 Uno de los parámetros no es válido.
PEER_E_GRAPH_NOT_READY
 El gráfico del mismo nivel nunca se ha sincronizado. Los registros no se pueden actualizar hasta que se haya sincronizado el gráfico.
PEER_E_INVALID_GRAPH
 El identificador del grafo del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED
 El gráfico del mismo nivel debe inicializarse con una llamada a PeerGraphStartup antes de usar esta función.
PEER_E_RECORD_NOT_FOUND
 No se encontró el registro especificado.

Comentarios

Se pueden modificar los siguientes miembros de la estructura de PEER_RECORD :

  • pwzAttributes
  • ftExpiration : la expiración solo se puede aumentar.
  • data
  • pwzLastModified : rellenado de forma predeterminada si no se proporciona ningún valor

Ejemplos

Este fragmento de código muestra cómo actualizar un registro.

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

Requisitos

   
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h
Library P2PGraph.lib
Archivo DLL P2PGraph.dll

Consulte también

PEER_RECORD