PeerPnrpGetEndpoint, fonction (p2p.h)
La fonction PeerPnrpGetEndpoint récupère une adresse de point de terminaison d’homologue résolue lors d’une opération de résolution de nom d’homologue asynchrone.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
[in] HRESOLUTION hResolve,
[out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);
Paramètres
[in] hResolve
Handle de l’opération de résolution de noms d’homologue asynchrone retournée par un appel précédent à PeerPnrpStartResolve.
[out] ppEndpoint
Pointeur vers l’adresse d’une structure de PEER_PNRP_ENDPOINT_INFO qui contient une adresse de point de terminaison pour le nom d’homologue fourni dans l’appel précédent à PeerPnrpStartResolve.
Ces données retournées par ce paramètre doivent être libérées en appelant PeerFreeData.
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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération spécifiée. |
|
Toutes les adresses de point de terminaison ont été récupérées pour l’homologue. |
Remarques
PeerPnrpStartResolve crée un handle pour une opération de résolution de noms d’homologue asynchrone.
Chaque fois qu’un point de terminaison est trouvé, le handle d’événement fourni dans hEvent est signalé et PeerPnrpGetEndpoint doit être appelé avec le handle phResolve par l’application pour obtenir ce point de terminaison.
Le dernier événement spécifie le code d’erreur PEER_E_NO_MORE, indiquant que tous les points de terminaison correspondant au nom d’homologue fourni à PeerPnrpStartResolve ont été trouvés. À ce stade, l’application doit fermer le handle avec un appel à PeerPnrpEndResolve.
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 |