Función PeerGroupGetRecord (p2p.h)

Artículo
03/15/2023

La función PeerGroupGetRecord recupera un registro de grupo específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Parámetros

[in] hGroup

Identificador de un grupo que contiene un registro específico. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pRecordId

Especifica el valor guid que identifica de forma única un registro necesario dentro de un grupo del mismo nivel. Este parámetro es obligatorio.

[out] ppRecord

Puntero a la dirección de una estructura PEER_RECORD que contiene un registro devuelto. Esta estructura se libera pasando su puntero a PeerFreeData. Este parámetro es obligatorio.

Valor devuelto

Devuelve S_OK si la operació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 recuperar los registros de grupo. 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_GROUP	El identificador de un grupo del mismo nivel no es válido.
PEER_E_RECORD_NOT_FOUND	No se puede encontrar un registro que coincida con el identificador proporcionado en una base de datos de grupo del mismo nivel.

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


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