Compartir a través de

Función PeerGroupGetProperties (p2p.h)

  • Artículo

La función PeerGroupGetProperties recupera información sobre las propiedades de un grupo especificado.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
  [in]  HGROUP                 hGroup,
  [out] PPEER_GROUP_PROPERTIES *ppProperties
);

Parámetros

[in] hGroup

Controle a un grupo del mismo nivel cuyas propiedades se recuperan. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[out] ppProperties

Puntero a una estructura de PEER_GROUP_PROPERTIES que contiene información sobre las propiedades del grupo del mismo nivel. Estos datos deben liberarse con 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 una operación especificada.
PEER_E_GROUP_NOT_READY
 El grupo no está en un estado en el que se pueden recuperar las propiedades del grupo del mismo nivel. Por ejemplo, se llama a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos de grupo.
PEER_E_INVALID_GROUP
 El identificador del grupo del mismo nivel no es válido.
 

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.

Comentarios

Las propiedades de grupo no se pueden recuperar si un elemento del mismo nivel no se ha sincronizado con una base de datos de grupo del mismo nivel. Para sincronizar con una base de datos de grupo del mismo nivel antes de llamar a esta función, primero llame a PeerGroupConnect.

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_GROUP_PROPERTIES

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupSetProperties