DhcpGetAllOptionValuesV6, fonction (dhcpsapi.h)

  • Article

La fonction DhcpGetAllOptionValuesV6 retourne un tableau qui contient toutes les valeurs d’option définies pour une étendue spécifique sur le serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpGetAllOptionValuesV6(
  [in]  LPWSTR                    ServerIpAddress,
  [in]  DWORD                     Flags,
  [in]  LPDHCP_OPTION_SCOPE_INFO6 ScopeInfo,
  [out] LPDHCP_ALL_OPTION_VALUES  *Values
);

Paramètres

[in] ServerIpAddress

Pointeur vers une chaîne Unicode qui spécifie l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] Flags

Spécifie un indicateur de bits qui indique si les options sont spécifiques au fournisseur. Si la qualification des options de fournisseur n’est pas nécessaire, ce paramètre doit être 0.

Valeur Signification
DHCP_FLAGS_OPTION_IS_VENDOR
 Cet indicateur doit être défini si des options spécifiques au fournisseur sont souhaitées.

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO6 structure qui contient des informations sur l’étendue spécifique dont les valeurs d’option seront retournées.

[out] Values

DHCP_ALL_OPTION_VALUES structure qui contient les valeurs d’option retournées pour l’étendue spécifiée dans ScopeInfo.

Remarque  

La mémoire de ce paramètre doit être libre à l’aide de DhcpRpcFreeMemory.

 

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, elle retourne l’un des codes d’erreur de l’API Gestion du serveur DHCP.

Code de retour Description
ERROR_INVALID_PARAMETER
 Les paramètres n’étaient pas valides.
ERROR_NO_MORE_ITEMS
 Plus d'éléments à énumérer.
ERROR_NOT_ENOUGH_MEMORY
 Échec de mémoire.
ERROR_MORE_DATA
 Plus de données sont disponibles pour énumérer.

Configuration requise

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