Compartir a través de

Función PeerGroupEnumMembers (p2p.h)

  • Artículo

La función PeerGroupEnumMembers crea una enumeración de los miembros del grupo del mismo nivel disponibles y la información de pertenencia asociada.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumMembers(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parámetros

[in] hGroup

Controle al grupo del mismo nivel cuyos miembros se enumeran. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] dwFlags

Especifica las marcas de PEER_MEMBER_FLAGS que indican qué tipos de miembros se van a incluir en la enumeración. Si este valor se establece en cero, se incluyen todos los miembros del grupo del mismo nivel.

Valor Significado
PEER_MEMBER_PRESENT
 Enumerar todos los miembros del grupo del mismo nivel actual que están en línea.

[in] pwzIdentity

Cadena Unicode que contiene la identidad de un par específico cuya información se recupera y se devuelve en una enumeración de un solo elemento. Si este parámetro es NULL, se recuperan todos los miembros del grupo del mismo nivel actual. Este parámetro es obligatorio.

[out] phPeerEnum

Puntero a la enumeración que contiene la lista de miembros del grupo del mismo nivel devueltas. Este identificador se pasa a
PeerGetNextItem para recuperar los elementos, con cada elemento representado como puntero a una estructura PEER_MEMBER . Cuando termine, se llama a PeerEndEnumeration para devolver la memoria usada por la enumeración. 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_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

El nodo local siempre es el primer elemento de la enumeración si pwzIdentity es NULL y dwFlags se establece para indicar que el nodo local es miembro del subconjunto explícito.

De forma predeterminada, cada miembro publica información de pertenencia en el grupo del mismo nivel. Si PEER_MEMBER_DATA_OPTIONAL se establece en los datos de PEER_MEMBER para ese mismo nivel, esta información solo está disponible cuando un elemento del mismo nivel realiza una acción dentro del grupo, por ejemplo, publicando un registro, actualizando presencia o emitiendo un GMC.

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

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem