GetInterfaceDnsSettings, fonction (netioapi.h)

  • Article

Récupère les paramètres DNS à partir de l’interface spécifiée dans le paramètre Interface . Lorsque vous avez terminé avec l’objet settings retourné, vous devez appeler FreeInterfaceDnsSettings pour le libérer.

Syntaxe

NETIOAPI_API GetInterfaceDnsSettings(
  GUID                   Interface,
  DNS_INTERFACE_SETTINGS *Settings
);

Paramètres

Interface

Type : _In_ GUID

GUID de l’interface COM à laquelle les paramètres font référence.

Settings

Type : _Inout_ const DNS_INTERFACE_SETTINGS*

GetInterfaceDnsSettings remplit tous les paramètres de cette structure.

Vous devez définir uniquement le membre Version ; Le champ Indicateurs doit être vide.

Si vous définissez le membre Version sur DNS_INTERFACE_SETTINGS_VERSION1, le paramètre Settings doit pointer vers une structure DNS_INTERFACE_SETTINGS valide.

Si vous définissez le membre Version sur DNS_INTERFACE_SETTINGS_VERSION2, le paramètre Settings doit pointer vers une structure DNS_INTERFACE_SETTINGS_EX valide.

Si vous définissez le membre Version sur DNS_INTERFACE_SETTINGS_VERSION3, le paramètre Settings doit pointer vers une structure DNS_INTERFACE_SETTINGS3 valide.

Valeur retournée

Retourne NO_ERROR en cas de réussite. Toute valeur autre que 0 indique un échec.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 Build 19041
Serveur minimal pris en charge Windows 10 Build 19041
Plateforme cible Windows
En-tête netioapi.h (include Iphlpapi.h)
Bibliothèque Iphlpapi.lib
DLL Iphlpapi.dll

Voir aussi