Compartir a través de


Función PeerEnumIdentities (p2p.h)

La función PeerEnumIdentities crea y devuelve un identificador de enumeración del mismo nivel que se usa para enumerar todas las identidades del mismo nivel que pertenecen a un usuario específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
  [out] HPEERENUM *phPeerEnum
);

Parámetros

[out] phPeerEnum

Recibe un identificador para la enumeración del mismo nivel que contiene la lista de identidades del mismo nivel, 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.

Comentarios

Una vez que la aplicación ha obtenido el identificador de enumeración del mismo nivel, use PeerGetNextItem y PeerGetItemCount para enumerar las identidades del mismo nivel.

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

Llame a PeerEndEnumeration para liberar el identificador de enumeración 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