Función PeerCollabEnumEndpoints (p2p.h)

La función PeerCollabEnumEndpoints devuelve el identificador a una enumeración que contiene los puntos de conexión asociados a un contacto del mismo nivel específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
  [in]  PCPEER_CONTACT pcContact,
  [out] HPEERENUM      *phPeerEnum
);

Parámetros

[in] pcContact

Puntero a una estructura de PEER_CONTACT que contiene la información de contacto de un par específico. Este parámetro no debe ser NULL.

[out] phPeerEnum

Puntero a un identificador para el conjunto enumerado de puntos de conexión asociados al contacto del mismo nivel proporcionado. Pase este identificador a PeerGetNextItem para obtener cada elemento del conjunto enumerado.

Valor devuelto

Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_OUTOFMEMORY	No hay suficiente memoria para admitir esta operación.
E_INVALIDARG	Uno de los argumentos no es válido.
PEER_E_NOT_INITIALIZED	La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente.
PEER_E_NOT_SIGNED_IN	La operación requiere que el usuario inicie sesión.

Comentarios

Se recomienda actualizar un registro de contacto mediante PeerCollabUpdateContact antes de llamar a PeerCollabEnumEndpoints. Si no lo hace, se puede devolver E_INVALIDARG.

Los puntos de conexión solo estarán disponibles para los contactos con fWatch establecido en true. Solo los puntos de conexión que tienen el contacto "Me" del elemento del mismo nivel de llamada guardado como un contacto de confianza y que tienen WatcherPermissions establecido para permitir estarán disponibles. Un contacto también debe iniciar sesión en Internet. En caso de que el contacto no haya iniciado sesión, se devolverá el error E_INVALIDARG .

Para obtener los puntos de conexión del mismo nivel individuales, pase el identificador devuelto a PeerGetNextItem. Se devolverá una matriz de punteros a PEER_ENDPOINT estructuras. Si no hay ningún punto de conexión disponible, se devolverá una matriz vacía. Para cerrar la enumeración y liberar los recursos asociados, pase este identificador a PeerEndEnumeration. Los elementos individuales devueltos por la enumeración deben liberarse con PeerFreeData.

El límite de conexiones a un único contacto es 50.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
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_ENDPOINT

Funciones de API de colaboración del mismo nivel