Función PeerPnrpStartResolve (p2p.h)

La función PeerPnrpStartResolve inicia una operación asincrónica de resolución de nombres del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpStartResolve(
  [in]           PCWSTR      pcwzPeerName,
  [in, optional] PCWSTR      pcwzCloudName,
  [in, optional] ULONG       cMaxEndpoints,
  [in]           HANDLE      hEvent,
  [out]          HRESOLUTION *phResolve
);

Parámetros

[in] pcwzPeerName

Puntero a una cadena terminada en cero que contiene el nombre del mismo nivel para el que se obtendrán las direcciones del punto de conexión.

[in, optional] pcwzCloudName

Puntero a una cadena terminada en cero que contiene el nombre de la nube PNRP en la que se va a resolver el nombre del mismo nivel. Si es NULL, la resolución se realiza para todas las nubes. Si PEER_PNRP_ALL_LINK_CLOUDS, la resolución se realiza para todas las nubes locales de vínculo. Cuando se especifica "GLOBAL_", la resolución tiene lugar en la nube global.

[in, optional] cMaxEndpoints

Número máximo de puntos de conexión que se van a devolver para el nombre del mismo nivel.

[in] hEvent

Identificador del evento señalado cuando se resuelve un punto de conexión del mismo nivel para el nombre del mismo nivel proporcionado y está listo para su consumo mediante una llamada a PeerPnrpGetEndpoint. Este evento se señala para cada punto de conexión detectado por el servicio PNRP. Si una llamada a PeerPnrpGetEndpoint devuelve PEER_NO_MORE, se han encontrado todos los puntos de conexión para ese mismo nivel.

[out] phResolve

Controle esta solicitud de resolución de nombres del mismo nivel. Este identificador se debe proporcionar a PeerPnrpEndResolve después de que se generen los eventos de resolución y los puntos de conexión se obtengan con las llamadas correspondientes a PeerPnrpGetEndpoint, o si se produce un error en la operación.

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

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 por parte de la aplicación para obtener ese punto de conexión.

El último evento especifica el código de error PEER_E_NO_MORE, 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.

Un identificador debe resolverse en un proceso independiente del proceso en el que se registró. Si se registra y se resuelve un identificador dentro del mismo proceso, no se reconocerá.

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

PeerPnrpGetEndpoint

PeerPnrpResolve