NDK_FN_GET_LISTENER_LOCAL_ADDRESS fonction de rappel (ndkpi.h)

  • Article

La fonction NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) retourne l’adresse locale d’un écouteur NDK.

Syntaxe

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

NTSTATUS NdkFnGetListenerLocalAddress(
  [in] NDK_LISTENER *pNdkListener,
       PSOCKADDR pAddress,
       ULONG *pAddressLength
)
{...}

Paramètres

[in] pNdkListener

Pointeur vers un objet écouteur NDK (NDK_LISTENER).

pAddress

Une adresse locale pour un écouteur est retournée dans cette mémoire tampon.

pAddressLength

La taille, en octets, de la mémoire tampon d’adresse pour l’entrée et la taille, en octets, de l’adresse réelle écrite dans la mémoire tampon pour la sortie.

Valeur retournée

La fonction NdkGetListenerLocalAddress retourne l’un des codes NTSTATUS suivants.

Code de retour Description
STATUS_SUCCESS
 Une adresse locale a été écrite dans la mémoire tampon dans le paramètre pAddress .
STATUS_BUFFER_TOO_SMALL
 La taille de la mémoire tampon spécifiée dans l’entrée du paramètre *pAddressLength est trop petite. *La valeur de sortie pAddressLength est mise à jour avec la taille de mémoire tampon requise.
Autres codes status
 Une erreur est survenue.

Remarques

NdkGetListenerLocalAddress retourne l’adresse locale d’un écouteur. L’adresse locale est utile pour récupérer les informations de port d’un AF_INET ou d’un écouteur AF_INET6. Par exemple, si le consommateur NDK spécifie zéro comme numéro de port ND dans une demande d’écoute et que le fournisseur NDK spécifie un port, le consommateur NDK peut utiliser NdkGetListenerLocalAddress pour déterminer le port spécifié par le fournisseur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête ndkpi.h (incluez Ndkpi.h)
IRQL <=DISPATCH_LEVEL

Voir aussi

NDK_FN_LISTEN

NDK_LISTENER