Fonction DhcpHlprCreateV4Policy (dhcpsapi.h)

Article
02/28/2024

La fonction DhcpHlprCreateV4Policy alloue et initialise une structure de stratégie de serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpHlprCreateV4Policy(
  [in]  LPWSTR              PolicyName,
  [in]  BOOL                fGlobalPolicy,
  [in]  DHCP_IP_ADDRESS     Subnet,
  [in]  DWORD               ProcessingOrder,
  [in]  DHCP_POL_LOGIC_OPER RootOperator,
  [in]  LPWSTR              Description,
  [in]  BOOL                Enabled,
  [out] LPDHCP_POLICY       *Policy
);

Paramètres

[in] PolicyName

Chaîne Unicode terminée par null qui contient le nom de la stratégie de serveur DHCP à créer.

[in] fGlobalPolicy

Si LA VALEUR EST TRUE , une stratégie au niveau du serveur est créée. Sinon, une stratégie au niveau de l’étendue est créée

[in] Subnet

DHCP_IP_ADDRESS structure qui contient l’adresse de sous-réseau IPv4 de la stratégie de niveau d’étendue à créer.

[in] ProcessingOrder

Entier qui spécifie l’ordre de traitement de la stratégie de serveur DHCP. 1 indique la priorité la plus élevée et MAX_DWORD indique la plus faible.

[in] RootOperator

DHCP_POL_LOGIC_OPER énumération qui définit la façon dont la condition de stratégie doit être évaluée en termes de résultats de ses composants.

[in] Description

Pointeur vers une chaîne Unicode terminée par null qui contient la description de la stratégie de serveur DHCP.

[in] Enabled

TRUE si la stratégie est activée. Sinon, il est FALSE.

[out] Policy

Pointeur vers une structure DHCP_POLICY qui contient les paramètres de la stratégie à créer.

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_NOT_ENOUGH_MEMORY	Mémoire disponible insuffisante.

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