GetAnycastIpAddressTable, fonction (netioapi.h)

Article
03/04/2024

La fonction GetAnycastIpAddressTable récupère la table d’adresses IP anycast sur l’ordinateur local.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetAnycastIpAddressTable(
  [in]  ADDRESS_FAMILY              Family,
  [out] PMIB_ANYCASTIPADDRESS_TABLE *Table
);

Paramètres

[in] Family

Famille d’adresses à récupérer.

Les valeurs possibles pour la famille d’adresses sont répertoriées dans le fichier d’en-tête Winsock2.h . Notez que les valeurs de la famille d’adresses AF_ et des constantes de famille de protocole PF_ sont identiques (par exemple , AF_INET et PF_INET), de sorte que l’une ou l’autre constante peut être utilisée.

Sur le SDK Windows publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé et les valeurs possibles pour ce membre sont définies dans le fichier d’en-tête Ws2def.h. Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.h et ne doit jamais être utilisé directement.

Les valeurs actuellement prises en charge sont AF_INET, AF_INET6 et AF_UNSPEC.

Valeur	Signification
AF_UNSPEC 0	La famille d’adresses n’est pas spécifiée. Lorsque ce paramètre est spécifié, cette fonction retourne la table d’adresses IP anycast contenant les entrées IPv4 et IPv6.
AF_INET 2	Famille d’adresses IPv4 (Internet Protocol version 4). Lorsque ce paramètre est spécifié, cette fonction retourne la table d’adresses IP anycast contenant uniquement des entrées IPv4.
AF_INET6 23	Famille d’adresses IPv6 (Internet Protocol version 6). Lorsque ce paramètre est spécifié, cette fonction retourne la table d’adresses IP anycast contenant uniquement des entrées IPv6.

[out] Table

Pointeur vers une structure MIB_ANYCASTIPADDRESS_TABLE qui contient une table d’entrées d’adresse IP anycast sur l’ordinateur 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_INVALID_PARAMETER	Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si un pointeur NULL est passé dans le paramètre Table ou si le paramètre Family n’a pas été spécifié comme AF_INET, AF_INET6 ou AF_UNSPEC.
ERROR_NOT_ENOUGH_MEMORY	Les ressources de mémoire sont insuffisantes pour terminer l’opération.
ERROR_NOT_FOUND	Aucune entrée d’adresse IP anycast spécifiée dans le paramètre Family n’a été trouvée.
ERROR_NOT_SUPPORTED	La demande n'est pas prise en charge. Cette erreur est retournée si aucune pile IPv4 ne se trouve sur l’ordinateur local et si AF_INET a été spécifié dans le paramètre Family . Cette erreur est également retournée si aucune pile IPv6 n’est sur l’ordinateur local et AF_INET6 a été spécifié dans le paramètre Family . Cette erreur est également retournée sur les versions de Windows où cette fonction n’est pas prise en charge.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

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

The
La fonction GetAnycastIpAddressTable énumère les adresses IP anycast sur un système local et retourne ces informations dans une structure MIB_ANYCASTIPADDRESS_TABLE .

Les entrées d’adresse IP anycast sont retournées dans une structure MIB_ANYCASTIPADDRESS_TABLE dans la mémoire tampon vers laquelle pointe le paramètre Table . La structure MIB_ANYCASTIPADDRESS_TABLE contient un nombre d’entrées d’adresses IP anycast et un tableau de structures MIB_ANYCASTIPADDRESS_ROW pour chaque entrée d’adresse IP anycast. Lorsque ces structures retournées ne sont plus nécessaires, libérez la mémoire en appelant FreeMibTable.

Le paramètre Family doit être initialisé sur AF_INET, AF_INET6 ou AF_UNSPEC.

Notez que la structure de MIB_ANYCASTIPADDRESS_TABLE retournée pointée par le paramètre Table peut contenir un remplissage pour l’alignement entre le membre NumEntries et la première entrée de tableau MIB_ANYCASTIPADDRESS_ROW dans le membre Table de la structure MIB_ANYCASTIPADDRESS_TABLE . Un remplissage pour l’alignement peut également être présent entre les entrées de tableau MIB_ANYCASTIPADDRESS_ROW . Tout accès à une entrée de tableau MIB_ANYCASTIPADDRESS_ROW doit supposer qu’un remplissage peut exister.

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	netioapi.h (include Iphlpapi.h)
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll

Voir aussi

FreeMibTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE

Partager via