Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die DhcpScanDatabase-Funktion listet die geleasten DHCPv4-Client-IPv4-Adressen auf, die nicht zwischen dem In-Memory-Cache und der Serverdatenbank synchronisiert werden.
Syntax
DWORD DHCP_API_FUNCTION DhcpScanDatabase(
[in] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_IP_ADDRESS SubnetAddress,
[in] DWORD FixFlag,
[out] LPDHCP_SCAN_LIST *ScanList
);
Parameter
[in] ServerIpAddress
Unicode-Zeichenfolge, die die IP-Adresse oder den Hostnamen des DHCP-Servers angibt.
[in] SubnetAddress
DHCP_IP_ADDRESS Wert, der das Subnetz angibt, dessen Leases auf desynchronisierte Clientleasing-IP-Adressen überprüft werden.
[in] FixFlag
Gibt eine Reihe von Bitflags an, die angeben, ob der In-Memory-Cache oder die Clientleasdatenbank die endgültige Quelle für Korrekturen sein soll, wenn die beiden auf dem DHCPv4-Server synchronisiert werden. Diese Flags werden in DHCP_SCAN_FLAG aufgelistet.
[out] ScanList
DHCP_SCAN_LIST Struktur, die die zurückgegebene Liste der nicht synchronisierten Client-IP-Adressen enthält.
Rückgabewert
Diese Funktion gibt bei einem erfolgreichen Aufruf ERROR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes der DHCP Server Management-API zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Dieser Aufruf wurde von einem Client ausgeführt, der nicht Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist. |
|
Beim Zugriff auf die Datenbank des DHCPv4-Servers ist ein Fehler aufgetreten. |
|
Das angegebene Subnetz ist auf dem DHCPv4-Server nicht definiert. |
Hinweise
Jede geleaste DHCPv4-Client-IPv4-Adresse, die auf einem DHCPv4-Server definiert ist, verfügt über einen Eintrag in einem In-Memory-Speicher, der als Cache zum Beschleunigen des Leaseabrufs dient, und in der richtigen Clientleasingdatenbank. DhcpScanDatabase listet entweder die IPv4-Adressen des DHCPv4-Clients auf, die im Speicher vorhanden sind und nicht in der Datenbank vorhanden sind, oder die Adressen, die in der Datenbank vorhanden sind, aber nicht im Speicher vorhanden sind.
Dieser Prozess ist erforderlich, da der DHCPv4-Server einen Speichercache mit häufig verwendeten Clientleases verwaltet, um die Leistung zu verbessern, aber er kann relativ zur persistenten Clientleasingdatenbank des Servers desynchronisiert werden. Daher ist es notwendig, die beiden Speicher abzugleichen und entweder die In-Memory-Version einer Clientleasing-IP-Adresse oder die in der Datenbank gespeicherte Clientleasing-IP-Adresse zu aktualisieren. Die DHCP_SCAN_LIST Struktur, die von diesem Vorgang zurückgegeben wird, enthält die "endgültigen" Clientleases, die durch den bevorzugten Speicherort angegeben werden, der im FixFlag-Parameter festgelegt ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dhcpsapi.h |
| Bibliothek | Dhcpsapi.lib |
| DLL | Dhcpsapi.dll |