GetUdp6Table, fonction (iphlpapi.h)

Article
03/01/2024

La fonction GetUdp6Table récupère la table d’écouteur UDP (User Datagram Protocol) IPv6.

Syntaxe

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

Paramètres

[out] Udp6Table

Pointeur vers une mémoire tampon qui reçoit la table d’écouteur UDP IPv6 en tant que structure MIB_UDP6TABLE .

[in, out] SizePointer

Lors de l’entrée, spécifie la taille en octets de la mémoire tampon pointée vers le paramètre Udp6Table .

En sortie, si la mémoire tampon n’est pas suffisamment grande pour contenir la table d’écouteurs retournée, la fonction définit ce paramètre sur la taille de mémoire tampon requise en octets.

[in] Order

Valeur booléenne qui spécifie si la table d’écouteur UDP retournée doit être triée. Si ce paramètre a la valeur TRUE, la table est triée dans l’ordre de :

Adresse IPv6 locale
ID d’étendue locale
Port local

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon pointée par le paramètre Udp6Table n’est pas assez grande. La taille requise est retournée dans la variable ULONG pointée vers par le paramètre SizePointer .
ERROR_INVALID_PARAMETER	Le paramètre SizePointer a la valeur NULL ou GetUdp6Table ne peut pas écrire dans la mémoire pointée par le paramètre SizePointer .
ERROR_NOT_SUPPORTED	Cette fonction n’est pas prise en charge sur le système d’exploitation utilisé sur le système local.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

La fonction GetUdp6Table est définie sur Windows Vista et versions ultérieures.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll