Compartir a través de

Función PeerGroupAddRecord (p2p.h)

  • Artículo

La función PeerGroupAddRecord agrega un nuevo registro al grupo del mismo nivel, que se propaga a todos los elementos del mismo nivel participantes.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Parámetros

[in] hGroup

Identificador del grupo del mismo nivel. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pRecord

Puntero a una estructura de PEER_RECORD que se agrega al grupo del mismo nivel especificado en hGroup. Este parámetro es obligatorio.

Los siguientes miembros de PEER_RECORD deben rellenarse.

  • dwSize
  • type
  • ftExpiration
ftExpiration debe expresarse como hora del mismo nivel (consulte PeerGroupUniversalTimeToPeerTime).

Los siguientes miembros se omiten y se sobrescriben si se rellenan.

  • id
  • pwzCreatorId
  • pwzLastModifiedById
  • ftCreation
  • ftLastModified
  • securityData
Los demás campos son opcionales.

[out] pRecordId

Puntero a un GUID que identifica el registro. Este parámetro es obligatorio.

Valor devuelto

Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto Descripción
E_INVALIDARG
 Uno de los parámetros no es válido.
E_OUTOFMEMORY
 No hay suficiente memoria para realizar la operación especificada.
PEER_E_GROUP_NOT_READY
 El grupo del mismo nivel no está en un estado en el que se pueden agregar registros. Por ejemplo, se llama a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos del grupo del mismo nivel.
PEER_E_INVALID_ATTRIBUTES
 La cadena XML que contiene los atributos de registro en el miembro pwzAttributes de la estructura PEER_RECORD no cumple con la especificación del esquema.
PEER_E_INVALID_GROUP
 El identificador del grupo del mismo nivel no es válido.
PEER_E_INVALID_PEER_NAME
 El nombre del mismo nivel proporcionado no es válido.
PEER_E_INVALID_RECORD
 Uno o varios campos de PEER_RECORD no son válidos.
PEER_E_MAX_RECORD_SIZE_EXCEEDED
 El registro ha superado el tamaño máximo permitido por las propiedades del grupo del mismo nivel.
PEER_E_NOT_AUTHORIZED
 La identidad no está autorizada para publicar un registro de ese tipo.
 

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

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 P2P.lib
Archivo DLL P2P.dll

Consulte también

PEER_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord