Partager via


GetMulticastIpAddressEntry, fonction (netioapi.h)

La fonction GetMulticastIpAddressEntry récupère des informations pour une entrée d’adresse IP de multidiffusion existante sur l’ordinateur local.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetMulticastIpAddressEntry(
  [in, out] PMIB_MULTICASTIPADDRESS_ROW Row
);

Paramètres

[in, out] Row

Pointeur vers une entrée de structure MIB_MULTICASTIPADDRESS_ROW pour une entrée d’adresse IP de multidiffusion. En cas de retour réussi, cette structure est mise à jour avec les propriétés d’une adresse IP de multidiffusion existante.

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_FILE_NOT_FOUND
Le système ne peut pas trouver le fichier spécifié. Cette erreur est retournée si l’interface réseau LUID ou l’index d’interface spécifié par le membre InterfaceLuid ou InterfaceIndex du MIB_MULTICASTIPADDRESS_ROW pointé par le paramètre Row n’est pas une valeur sur l’ordinateur local.
ERROR_INVALID_PARAMETER
Un paramètre est incorrect. Cette erreur est retournée si un pointeur NULL est passé dans le paramètre Row , si le membre Address du MIB_MULTICASTIPADDRESS_ROW pointé par le paramètre Row n’est pas défini sur une adresse IPv4 ou IPv6 de multidiffusion valide, ou si les membres InterfaceLuid ou InterfaceIndex du MIB_MULTICASTIPADDRESS_ROW pointés par le paramètre Row ne sont pas spécifiés.
ERROR_NOT_FOUND
Element not found. Cette erreur est retournée si l’interface réseau spécifiée par le membre InterfaceLuid ou InterfaceIndex de la structure MIB_MULTICASTIPADDRESS_ROW pointée par le paramètre Row ne correspond pas à l’adresse IP et à la famille d’adresses spécifiées dans le membre Address dans la structure MIB_MULTICASTIPADDRESS_ROW .
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 qu’une adresse IPv4 est spécifiée dans le membre Address MIB_MULTICASTIPADDRESS_ROW pointé par le paramètre Row. Cette erreur est également retournée si aucune pile IPv6 ne se trouve sur l’ordinateur local et qu’une adresse IPv6 est spécifiée dans le membre Address .
Autres
Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

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

La fonction GetMulticastIpAddressEntry est utilisée pour récupérer une entrée de structure MIB_MULTICASTIPADDRESS_ROW existante.

Lors de l’entrée, le membre Address dans la structure MIB_MULTICASTIPADDRESS_ROW pointée vers le paramètre Row doit être initialisé vers une adresse et une famille IPv4 ou IPv6 de multidiffusion valides. En outre, au moins un des membres suivants dans la structure MIB_MULTICASTIPADDRESS_ROW pointant vers le paramètre Row doit être initialisé : InterfaceLuid ou InterfaceIndex.

Les champs sont utilisés dans l’ordre indiqué ci-dessus. Ainsi, si l’InterfaceLuid est spécifié, ce membre est utilisé pour déterminer l’interface. Si aucune valeur n’est définie pour le membre InterfaceLuid (la valeur de ce membre est définie sur zéro), le membre InterfaceIndex est ensuite utilisé pour déterminer l’interface.

Lors de la sortie lorsque l’appel réussit, GetMulticastIpAddressEntry récupère les autres propriétés de l’adresse IP de multidiffusion et remplit la structure MIB_MULTICASTIPADDRESS_ROW pointée par le paramètre Row .

La fonction GetMulticastIpAddressTable peut être appelée pour énumérer les entrées d’adresse IP de multidiffusion sur un ordinateur local.

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

GetMulticastIpAddressTable

MIB_MULTICASTIPADDRESS_ROW

MIB_MULTICASTIPADDRESS_TABLE