DhcpV4FailoverSetRelationship, fonction (dhcpsapi.h)

  • Article

La fonction DhcpV4FailoverSetRelationship définit ou modifie les paramètres d’une relation de basculement de serveur DHCPv4.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4FailoverSetRelationship(
  [in, optional] LPWSTR                       ServerIpAddress,
  [in]           DWORD                        Flags,
  [in]           LPDHCP_FAILOVER_RELATIONSHIP pRelationship
);

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

Masque de bits qui spécifie les champs à mettre à jour dans pRelationship. Chaque valeur spécifie un membre de la structure DHCP_FAILOVER_RELATIONSHIP à modifier.

Indicateur Signification
MCLT
0x00000001
 Le membre mclt dans la structure de paramètre pRelationship est renseigné.
SAFEPERIOD
0x00000002
 Le membre safePeriod dans la structure de paramètres pRelationship est renseigné.
CHANGESTATE
0x00000004
 Le membre d’état dans la structure de paramètres pRelationship est renseigné.
POURCENTAGE
0x00000008
 Le membre de pourcentage dans la structure de paramètre pRelationship est renseigné.
MODE
0x00000010
 Le membre de mode dans la structure de paramètre pRelationship est renseigné.
PREVSTATE
0x00000020
 Le membre prevState dans la structure de paramètre pRelationship est renseigné.

[in] pRelationship

Pointeur vers une structure de DHCP_FAILOVER_RELATIONSHIP qui contient des informations de mise à jour sur les champs dans la relation de basculement DHCPv4.

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_FO_RELATIONSHIP_DOES_NOT_EXIST
 La relation de basculement n’existe pas.

Spécifications

   
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

Voir aussi

DhcpV4FailoverCreateRelationship

DhcpV4FailoverDeleteRelationship

DhcpV4FailoverEnumRelationship

DhcpV4FailoverGetRelationship