Compartir a través de

Función PeerPnrpGetEndpoint (p2p.h)

  • Artículo

La función PeerPnrpGetEndpoint recupera una dirección de punto de conexión del mismo nivel resuelta durante una operación asincrónica de resolución de nombres del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
  [in]  HRESOLUTION              hResolve,
  [out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);

Parámetros

[in] hResolve

Identificador de la operación asincrónica de resolución de nombres del mismo nivel devuelta por una llamada anterior a PeerPnrpStartResolve.

[out] ppEndpoint

Puntero a la dirección de una estructura de PEER_PNRP_ENDPOINT_INFO que contiene una dirección de punto de conexión para el nombre del mismo nivel proporcionado en la llamada anterior a PeerPnrpStartResolve.

Estos datos devueltos por este parámetro deben liberarse llamando a PeerFreeData.

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_NO_MORE
 Todas las direcciones de punto de conexión se han recuperado para el mismo nivel.

Comentarios

PeerPnrpStartResolve crea un identificador para una operación asincrónica de resolución de nombres del mismo nivel.

Cada vez que se encuentra un punto de conexión, se señala el identificador de eventos proporcionado en hEvent y se debe llamar a PeerPnrpGetEndpoint con el identificador phResolve de la aplicación para obtener ese punto de conexión.

El último evento especifica el PEER_E_NO_MORE código de error, lo que indica que se han encontrado todos los puntos de conexión correspondientes al nombre del mismo nivel proporcionados a PeerPnrpStartResolve . En este momento, la aplicación debe cerrar el identificador con una llamada a PeerPnrpEndResolve.

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 Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado p2p.h
Library P2P.lib
Archivo DLL P2P.dll

Consulte también

PeerPnrpEndResolve

PeerPnrpStartResolve