Fonction DhcpV4GetAllOptionValues (dhcpsapi.h)

La fonction DhcpV4GetAllOptionValues récupère un tableau de valeurs d’option DHCP (le code d’option et les données associées) pour une étendue particulière.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4GetAllOptionValues(
  [in, optional] LPWSTR                      ServerIpAddress,
  [in]           DWORD                       Flags,
  [in]           LPDHCP_OPTION_SCOPE_INFO    ScopeInfo,
  [out]          LPDHCP_ALL_OPTION_VALUES_PB *Values
);

Paramètres

[in, optional] ServerIpAddress

Pointeur vers une chaîne Unicode terminée par null qui représente l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] Flags

Indique si les valeurs d’option concernent un fournisseur spécifique ou un fournisseur par défaut.

Indicateurs	Signification
0x00000000	Les valeurs d’option sont récupérées pour un fournisseur par défaut.
DHCP_FLAGS_OPTION_IS_VENDOR 0x00000003	Les valeurs d’option sont récupérées pour des fournisseurs spécifiques.

[in] ScopeInfo

Pointeur vers une structure DHCP_OPTION_SCOPE_INFO qui contient des informations sur l’étendue des valeurs d’option à récupérer.

[out] Values

Pointeur vers une structure DHCP_ALL_OPTION_VALUES_PB qui contient les valeurs d’option récupérées pour l’étendue spécifiée dans ScopeInfo.

Il existe une valeur d’option dans le tableau pour chaque paire fournisseur/stratégie définie sur le serveur DHCP.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants ou un code d’erreur à partir des codes d’erreur de l’API gestion du serveur DHCP.

Valeur	Signification
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres n’étaient pas valides.

Notes

Les valeurs doivent être libres à l’aide de DhcpRpcFreeMemory.

Spécifications

Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dhcpsapi.h
Bibliothèque	Dhcpsapi.lib
DLL	Dhcpsapi.dll

Voir aussi

DhcpV4GetOptionValue

DhcpV4RemoveOptionValue

DhcpV4SetOptionValue

DhcpV4SetOptionValues