Función PeerEnumGroups (p2p.h)

La función PeerEnumGroups crea y devuelve un identificador de enumeración del mismo nivel que se usa para enumerar todos los grupos del mismo nivel asociados a una identidad del mismo nivel específica.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parámetros

[in] pwzIdentity

Especifica la identidad del mismo nivel para la que se van a enumerar los grupos.

[out] phPeerEnum

Recibe un identificador de la enumeración del mismo nivel que contiene la lista de grupos del mismo nivel de los que la identidad especificada es miembro, con cada elemento representado como puntero a una estructura de PEER_NAME_PAIR . Pase este identificador a PeerGetNextItem para recuperar los elementos; cuando termine, llame a PeerEndEnumeration para liberar la memoria.

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_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar la operación especificada.
PEER_E_NOT_FOUND	No se encuentra la identidad del mismo nivel especificada.

Comentarios

Una vez que la aplicación haya obtenido el identificador de enumeración, use PeerGetNextItem y PeerGetItemCount para enumerar los grupos del mismo nivel.

Al enumerar grupos del mismo nivel, PeerGetNextItem devuelve una matriz de punteros a PEER_NAME_PAIR estructuras.

Llame a PeerEndEnumeration para liberar el identificador de enumeración del mismo nivel cuando ya no sea necesario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack para Windows 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_NAME_PAIR

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem