Fonction DhcpGetOptionValue (dhcpsapi.h)

La fonction DhcpGetOptionValue récupère une valeur d’option DHCP (le code d’option et les données associées) pour une étendue particulière.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpGetOptionValue(
  [in]  DHCP_CONST WCHAR                  *ServerIpAddress,
  [in]  DHCP_OPTION_ID                    OptionID,
  [in]  DHCP_CONST DHCP_OPTION_SCOPE_INFO *ScopeInfo,
  [out] LPDHCP_OPTION_VALUE               *OptionValue
);

Paramètres

[in] ServerIpAddress

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

[in] OptionID

DHCP_OPTION_ID valeur qui spécifie le code de la valeur d’option à récupérer.

[in] ScopeInfo

DHCP_OPTION_SCOPE_INFO structure qui contient des informations sur l’étendue où la valeur d’option est définie.

[out] OptionValue

DHCP_OPTION_VALUE structure qui contient le code et les données d’option retournés.

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, il retourne l’un des codes d’erreur de l’API gestion du serveur DHCP.

Remarques

Cette fonction nécessite l’ordre des octets de l’hôte pour toutes les valeurs DHCP_IP_ADDRESS dans les structures de paramètres.

Configuration requise

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

Voir aussi

DHCP_OPTION_VALUE