Compartir a través de

Función PeerGraphAddRecord (p2p.h)

  • Artículo

La función PeerGraphAddRecord agrega un nuevo registro a un grafo del mismo nivel. Se envía un registro agregado con esta función a cada nodo de un grafo del mismo nivel.

Sintaxis

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

Parámetros

[in] hGraph

Identificador de un grafo del mismo nivel.

[in] pRecord

Puntero a un registro que se va a agregar.

[out] pRecordId

Especifica el identificador de registro que identifica de forma única un registro en un gráfico del mismo nivel.

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_ACCESSDENIED
 No se puede acceder a un grafo del mismo nivel.
E_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar una operación especificada.
PEER_E_GRAPH_NOT_READY
 Un grafo no está sincronizado. No se pueden agregar registros hasta que se sincronice el grafo del mismo nivel.
PEER_E_GRAPH_SHUTTING_DOWN

Se ha llamado a PeerGraphClose.
PEER_E_INVALID_ATTRIBUTES
 Los atributos especificados no coinciden con el esquema.
PEER_E_INVALID_GRAPH
 El identificador de un grafo del mismo nivel no es válido.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 El registro supera el tamaño máximo permitido por un grafo del mismo nivel.
PEER_E_NOT_INITIALIZED
 El grafo debe inicializarse con una llamada a PeerGraphStartup, antes de usar esta función.

Comentarios

Los siguientes miembros de la estructura PEER_RECORD deben contener valores válidos:

  • dwSize.
  • type.
  • ftExpiration : debe ser posterior a la hora del gráfico actual y debe especificarse en el tiempo del mismo nivel mediante PeerGraphUniversalTimeToPeerTime.
Los siguientes miembros de la estructura PEER_RECORD son opcionales. Establézcalos en NULL si la aplicación no las usa:
  • data
  • pwzAttributes
  • securityData
  • dwVersion
Si alguno de los siguientes miembros es NULL, Peer Graphing API realiza el comportamiento predeterminado especificado: No se pueden especificar los siguientes miembros; La infraestructura de Peer Graphing sobrescribe cualquier valor usado:
  • id.
  • ftCreation : usa el tiempo del mismo nivel.
  • ftLastModified : usa el tiempo del mismo nivel.

Requisitos

Requisito Value
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

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate