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.
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 |