PeerPnrpResolve, fonction (p2p.h)

Article
03/01/2024

La fonction PeerPnrpResolve obtient la ou les adresses de point de terminaison inscrites pour un nom d’homologue spécifique.

Syntaxe

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

Paramètres

[in] pcwzPeerName

Pointeur vers une chaîne sans fin qui contient le nom d’homologue pour lequel les adresses de point de terminaison seront obtenues.

[in, optional] pcwzCloudName

Pointeur vers une chaîne sans fin qui contient le nom du cloud PNRP sous lequel résoudre le nom de l’homologue. Si la valeur est NULL, la résolution est effectuée dans tous les clouds. Si PEER_PNRP_ALL_LINK_CLOUDS, la résolution est effectuée dans tous les clouds locaux de liaison. Lorsque « GLOBAL_ », la résolution n’aura lieu que dans le cloud global.

[in, out] pcEndpoints

Nombre maximal de points de terminaison à retourner dans ppEndpoints. Lors du retour, ce paramètre contient le nombre réel de points de terminaison dans ppEndpoints.

[out] ppEndpoints

Pointeur vers une liste de structures PEER_PNRP_ENDPOINT_INFO qui contiennent les points de terminaison pour lesquels le nom de l’homologue a été résolu avec succès. Chaque point de terminaison contient une ou plusieurs adresses IP auxquelles le nœud homologue peut être atteint.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.

Remarques

Cet appel est synchrone et se bloque jusqu’à ce qu’il soit terminé. Pour la résolution asynchrone des noms d’homologues, appelez PeerPnrpStartResolve et obtenez l’adresse de point de terminaison résolue lorsque l’événement fourni est déclenché.

Un handle doit être résolu dans un processus distinct du processus dans lequel il a été inscrit. Si un handle est inscrit et résolu dans le même processus, il n’est pas reconnu.

Lorsque la résolution est effectuée pour tous les clouds, elle est émise dans chaque cloud simultanément. La méthode retourne dès qu’elle a reçu suffisamment de résultats à partir d’une combinaison de nuages.

Le délai d’attente de résolution par défaut utilisé en interne par cette méthode est de 30 secondes. Si un délai d’attente spécifique est requis, la fonction peerPnrpStartResolve asynchrone doit être utilisée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PeerPnrpStartResolve

Partager via