Fonction DhcpV4FailoverCreateRelationship (dhcpsapi.h)

Article
08/23/2023

La fonction DhcpV4FailoverCreateRelationship crée une relation de basculement DHCPv4 entre deux serveurs.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4FailoverCreateRelationship(
  [in, optional] LPWSTR                       ServerIpAddress,
  [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] pRelationship

Pointeur vers une structure DHCP_FAILOVER_RELATIONSHIP qui contient des informations sur la relation de basculement DHCPv4 à 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_DHCP_SUBNET_NOT_PRESENT	L’étendue IPv4 n’existe pas sur le serveur DHCPv4.
ERROR_DHCP_FO_SCOPE_ALREADY_IN_RELATIONSHIP	IPv4 fait déjà partie d’une autre relation de basculement.
ERROR_DHCP_FO_RELATIONSHIP_EXISTS	Une relation de basculement portant le même nom existe déjà sur le serveur DHCPv4.
ERROR_DHCP_FO_RELATIONSHIP_NAME_TOO_LONG	Le nom de la relation de basculement est plus long que la longueur attendue.
ERROR_DHCP_FO_MAX_RELATIONSHIPS	Le nombre maximal de relations de basculement autorisées configurées sur le serveur DHCP a été dépassé.

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

DhcpV4FailoverDeleteRelationship

DhcpV4FailoverEnumRelationship

DhcpV4FailoverGetRelationship

DhcpV4FailoverSetRelationship

Partager via