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 |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
Uno de los argumentos no es válido. |
|
La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente. |
|
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 |