Compartir a través de

Función PeerPnrpResolve (p2p.h)

  • Artículo

La función PeerPnrpResolve obtiene las direcciones de punto de conexión registradas para un nombre del mismo nivel específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpResolve(
  [in]           PCWSTR                   pcwzPeerName,
  [in, optional] PCWSTR                   pcwzCloudName,
  [in, out]      ULONG                    *pcEndpoints,
  [out]          PPEER_PNRP_ENDPOINT_INFO *ppEndpoints
);

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 en todas las nubes. Si PEER_PNRP_ALL_LINK_CLOUDS, la resolución se realiza en todas las nubes locales de vínculo. Cuando "GLOBAL_", la resolución solo tendrá lugar en la nube global.

[in, out] pcEndpoints

Número máximo de puntos de conexión que se van a devolver en ppEndpoints. Tras la devolución, este parámetro contiene el número real de puntos de conexión en ppEndpoints.

[out] ppEndpoints

Puntero a una lista de PEER_PNRP_ENDPOINT_INFO estructuras que contienen los puntos de conexión para los que el nombre del mismo nivel se resolvió correctamente. Cada punto de conexión contiene una o varias direcciones IP en las que se puede acceder al nodo del mismo nivel.

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

Esta llamada es sincrónica y se bloqueará hasta que se complete. Para la resolución asincrónica de nombres del mismo nivel, llame a PeerPnrpStartResolve y obtenga la dirección del punto de conexión resuelto cuando se genere el evento proporcionado.

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á.

Cuando se realiza la resolución para todas las nubes, se emite a cada nube simultáneamente. El método devolverá tan pronto como haya recibido suficientes resultados de cualquier combinación de nubes.

El tiempo de espera de resolución predeterminado usado internamente por este método es de 30 segundos. Si se requiere un tiempo de espera específico, se debe usar la función asincrónica PeerPnrpStartResolve .

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

PeerPnrpStartResolve