Funzione DhcpV4FailoverAddScopeToRelationship (dhcpsapi.h)

Articolo
02/26/2024

La funzione DhcpV4FailoverAddScopeToRelationship aggiunge un ambito DHCPv4 alla relazione di failover specificata.

Sintassi

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

Parametri

[in, optional] ServerIpAddress

Puntatore a una stringa Unicode con terminazione null che rappresenta l'indirizzo IP o il nome host del server DHCP.

[in] pRelationship

Puntatore a una struttura DHCP_FAILOVER_RELATIONSHIP che contiene sia le informazioni sull'ambito da aggiungere che la relazione di failover da modificare.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti o un codice di errore da codici di errore dell'API di gestione server DHCP.

Valore	Significato
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
ERROR_DHCP_SUBNET_NOT_PRESENT	L'ambito IPv4 non esiste nel server DHCPv4.
ERROR_DHCP_FO_SCOPE_ALREADY_IN_RELATIONSHIP	L'ambito IPv4 fa già parte di un'altra relazione di failover.
ERROR_DHCP_FO_RELATIONSHIP_DOES_NOT_EXIST	La relazione di failover non esiste.
ERROR_DHCP_FO_MAX_ADD_SCOPES	Il numero di ambiti aggiunti alla relazione di failover supera il numero massimo di ambiti che possono essere aggiunti a una relazione di failover alla volta.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dhcpsapi.h
Libreria	Dhcpsapi.lib
DLL	Dhcpsapi.dll

Vedi anche

DhcpV4FailoverDeleteScopeFromRelationship

DhcpV4FailoverGetScopeRelationship

DhcpV4FailoverGetScopeStatistics

Condividi tramite