Fonction DhcpHlprAddV4PolicyCondition (dhcpsapi.h)

Article
02/29/2024

La fonction DhcpHlprAddV4PolicyCondition alloue, initialise et ajoute une condition de stratégie de serveur DHCP à une stratégie de serveur DHCP.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpHlprAddV4PolicyCondition(
  [in, out] LPDHCP_POLICY       Policy,
  [in]      DWORD               ParentExpr,
  [in]      DHCP_POL_ATTR_TYPE  Type,
  [in]      DWORD               OptionID,
  [in]      DWORD               SubOptionID,
  [in]      LPWSTR              VendorName,
  [in]      DHCP_POL_COMPARATOR Operator,
            LPBYTE              Value,
  [in]      DWORD               ValueLength,
  [out]     DWORD               *ConditionIndex
);

Paramètres

[in, out] Policy

Pointeur vers une structure DHCP_POLICY qui contient la stratégie à modifier.

[in] ParentExpr

Entier qui spécifie l’index d’expression qui correspond à cette condition constituante.

[in] Type

DHCP_POL_ATTR_TYPE énumération qui spécifie le type d’attribut pour cette condition.

[in] OptionID

DHCP_OPTION_ID valeur qui spécifie l’identificateur d’option unique pour les critères basés sur les options ou sous-options DHCP.

[in] SubOptionID

DHCP_OPTION_ID valeur qui spécifie l’identificateur unique de sous-option pour les critères basés sur les sous-options DHCP.

[in] VendorName

Pointeur vers une chaîne Unicode terminée par null qui représente le nom du fournisseur.

[in] Operator

DHCP_POL_COMPARATOR énumération qui spécifie l’opérateur de comparaison pour la condition.

Value

Pointeur vers un tableau d’octets qui contient la valeur à utiliser pour la comparaison.

[in] ValueLength

Entier qui spécifie la longueur de Value.

[out] ConditionIndex

Pointeur vers un DWORD qui contient l’index de la condition nouvellement créée dans la stratégie de serveur DHCP.

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.
ERROR_DHCP_POLICY_BAD_PARENT_EXPR	L’expression parente spécifiée 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