Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction GetMulticastIpAddressTable récupère la table d’adresses IP de multidiffusion sur un ordinateur local.
Syntaxe
NETIOAPI_API GetMulticastIpAddressTable(
_In_ ADDRESS_FAMILY Family,
_Out_ PMIB_MULTICASTIPADDRESS_TABLE *Table
);
Paramètres
Family [in]
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 protocoles PF_ sont identiques (par exemple, AF_INET et PF_INET), afin de pouvoir utiliser l’une ou l’autre constante.
Sur Windows Vista et les versions ultérieures des systèmes d’exploitation Windows, les valeurs possibles pour le paramètre Family 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 Netioapi.h et que vous ne devez jamais utiliser Ws2def.h directement.
Les valeurs suivantes sont actuellement prises en charge pour la famille d’adresses :
AF_INET
Famille d’adresses IPv4. Lorsque cette valeur est spécifiée, cette fonction retourne la table d’adresses IP de multidiffusion qui contient uniquement des entrées IPv4.AF_INET6
Famille d’adresses IPv6. Lorsque cette valeur est spécifiée, cette fonction retourne la table d’adresses IP de multidiffusion qui contient uniquement des entrées IPv6.AF_UNSPEC
La famille d’adresses n’est pas spécifiée. Lorsque cette valeur est spécifiée, cette fonction retourne la table d’adresses IP de multidiffusion qui contient les entrées IPv4 et IPv6.
table [out]
Pointeur vers une structure MIB_MULTICASTIPADDRESS_TABLE qui contient une table des entrées d’adresse IP de anycast sur l’ordinateur local.
Valeur de retour
GetMulticastIpAddressTable retourne STATUS_SUCCESS si la fonction réussit.
Si la fonction échoue, GetMulticastIpAddressTable retourne l’un des codes d’erreur suivants :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un paramètre non valide a été passé à la fonction. Cette erreur est retournée si un pointeur NULL est transmis 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. |
| STATUS_NOT_ENOUGH_MEMORY | Les ressources de mémoire insuffisantes sont disponibles pour terminer l’opération. |
| STATUS_NOT_FOUND | Aucune entrée d’adresse IP anycast, comme spécifié dans le paramètre Family, a été trouvée. |
| STATUS_NOT_SUPPORTED | La demande n’est pas prise en charge. Cette erreur est retournée si aucune pile IPv4 n’est située sur l’ordinateur local et que AF_INET a été spécifié dans le paramètre famille, ou si aucune pile IPv6 n’est située sur l’ordinateur local et que 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 la fonction FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Remarques
La fonction GetMulticastIpAddressTable énumère les adresses IP de multidiffusion sur un ordinateur local et retourne ces informations dans une structure MIB_MULTICASTIPADDRESS_TABLE.
GetMulticastIpAddressTable retourne les entrées d’adresse IP de multidiffusion dans une structure MIB_MULTICASTIPADDRESS_TABLE dans la mémoire tampon vers laquelle pointe le paramètre table. La structure MIB_MULTICASTIPADDRESS_TABLE contient un nombre d’entrées d’adresse IP multidiffusion et un tableau de structures MIB_MULTICASTIPADDRESS_ROW pour chaque entrée d’adresse IP de multidiffusion. Lorsque ces structures retournées ne sont plus requises, votre pilote doit libérer la mémoire en appelant FreeMibTable.
Votre pilote doit initialiser le paramètre Family sur AF_INET, AF_INET6 ou AF_UNSPEC.
Notez que la structure MIB_MULTICASTIPADDRESS_TABLE retournée par laquelle le paramètre Table peut contenir un remplissage pour l’alignement entre le membre NumEntries et la première entrée de tableau MIB_MULTICASTIPADDRESS_ROW dans le membre Table de la structure MIB_MULTICASTIPADDRESS_TABLE. Le remplissage pour l’alignement peut également être présent entre les entrées du tableau MIB_MULTICASTIPADDRESS_ROW. Tout accès à une entrée de tableau MIB_MULTICASTIPADDRESS_ROW doit supposer que le remplissage peut exister.