DhcpV4QueryPolicyEnforcement, fonction (dhcpsapi.h)

Article
02/29/2024

La fonction DhcpV4QueryPolicyEnforcement récupère l’état d’application de stratégie sur le serveur ou le sous-réseau IPv4 spécifié à partir du serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4QueryPolicyEnforcement(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [out]          BOOL            *Enabled
);

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] fGlobalPolicy

Si la valeur EST TRUE , l’état d’application de la stratégie du serveur est récupéré. Sinon, l’état d’application de la stratégie de l’étendue Ipv4 spécifiée est récupéré.

[in] SubnetAddress

DHCP_IP_ADDRESS structure qui contient l’adresse de sous-réseau IPv4 de l’état d’application de la stratégie à récupérer.

[out] Enabled

Pointeur vers un BOOL qui indique l’état de l’application de la stratégie. Si la valeur EST TRUE , l’état d’application de la stratégie est activé. Sinon, l’état d’application de la stratégie est désactivé.

Note La mémoire pour cela doit être allouée par l’appelant.

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.
ERROR_DHCP_SUBNET_NOT_PRESENT	Le sous-réseau IPv4 spécifié n’existe pas.

Configuration requise

Condition requise	Valeur
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