Funzione DhcpV4GetPolicy (dhcpsapi.h)

Articolo
02/29/2024

La funzione DhcpV4GetPolicy recupera un criterio dal server DHCP.

Sintassi

DWORD DHCP_API_FUNCTION DhcpV4GetPolicy(
  [in, optional] LPWSTR          ServerIpAddress,
  [in]           BOOL            fGlobalPolicy,
  [in]           DHCP_IP_ADDRESS SubnetAddress,
  [in]           LPWSTR          PolicyName,
  [out]          LPDHCP_POLICY   *Policy
);

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

Se viene recuperato il criterio a livello di server true. In caso contrario, i criteri a livello di ambito vengono recuperati.

[in] SubnetAddress

DHCP_IP_ADDRESS struttura contenente l'indirizzo della subnet IPv4 del criterio da recuperare.

[in] PolicyName

Stringa Unicode con terminazione null che rappresenta il nome del criterio da recuperare.

[out] Policy

Puntatore a una struttura DHCP_POLICY contenente i parametri dei criteri richiesti in PolicyName.

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	La subnet IPv4 specificata non esiste.
ERROR_DHCP_POLICY_NOT_FOUND	Non è stato trovato il criterio del server DHCP.

Commenti

I criteri devono essere gratuiti usando DhcpRpcFreeMemory.

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