Fonction DhcpV4FailoverAddScopeToRelationship (dhcpsapi.h)

  • Article

La fonction DhcpV4FailoverAddScopeToRelationship ajoute une étendue DHCPv4 à la relation de basculement spécifiée.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4FailoverAddScopeToRelationship(
  [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 à la fois les informations d’étendue à ajouter et la relation de basculement à modifier.

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
 L’étendue IPv4 fait déjà partie d’une autre relation de basculement.
ERROR_DHCP_FO_RELATIONSHIP_DOES_NOT_EXIST
 La relation de basculement n’existe pas.
ERROR_DHCP_FO_MAX_ADD_SCOPES
 Le nombre d’étendues ajoutées à la relation de basculement dépasse le nombre maximal d’étendues qui peuvent être ajoutées à une relation de basculement à la fois.

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

Voir aussi

DhcpV4FailoverDeleteScopeFromRelationship

DhcpV4FailoverGetScopeRelationship

DhcpV4FailoverGetScopeStatistics