DhcpServerGetConfigV4-Funktion (dhcpsapi.h)

Die DhcpServerGetConfigV4-Funktion gibt die spezifischen Konfigurationseinstellungen eines DHCP-Servers zurück. Diese Funktion erweitert die Funktionalität von DhcpServerGetConfig, indem Konfigurationsparameter für die Anzahl von Ping-Wiederholungen hinzugefügt werden, die ein Server verwendet, um die Verbindungsfähigkeit, die Einstellungen für die Startdateitabelle und den Überwachungsprotokollzustand zu bestimmen. Die Konfigurationsinformationen enthalten Informationen zur JET-Datenbank, die zum Speichern von Subnetz- und Clientleasinginformationen verwendet wird, sowie zu den unterstützten Protokollen.

Syntax

DWORD DHCP_API_FUNCTION DhcpServerGetConfigV4(
  [in]  DHCP_CONST WCHAR             *ServerIpAddress,
  [out] LPDHCP_SERVER_CONFIG_INFO_V4 *ConfigInfo
);

Parameter

[in] ServerIpAddress

Unicode-Zeichenfolge, die die IP-Adresse oder den Hostnamen des DHCP-Servers angibt.

[out] ConfigInfo

Zeiger auf eine DHCP_SERVER_CONFIG_INFO_V4-Struktur , die die spezifischen Konfigurationsinformationen für den DHCP-Server enthält.

Hinweis  

Der Arbeitsspeicher für diesen Parameter muss mit DhcpRpcFreeMemory frei sein.

 

Rückgabewert

Diese Funktion gibt bei einem erfolgreichen Aufruf ERROR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes der DHCP-Serververwaltungs-API zurückgegeben.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Dieser Aufruf wurde von einem Client ausgeführt, der kein Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist.
ERROR_DHCP_JET_ERROR	Fehler beim Zugriff auf die Datenbank des DHCP-Servers.
ERROR_INVALID_PARAMETER	Einer der Parameter stellt einen ungültigen Wert bereit.

Anforderungen

Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dhcpsapi.h
Bibliothek	Dhcpsapi.lib
DLL	Dhcpsapi.dll

Weitere Informationen

DHCP_SERVER_CONFIG_INFO_V4

DhcpServerSetConfigV4