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 DhcpV4CreateClientInfo-Funktion erstellt einen DHCPv4-Clientleasingdatensatz in der DHCP-Serverdatenbank.
Syntax
DWORD DHCP_API_FUNCTION DhcpV4CreateClientInfo(
[in, optional] DHCP_CONST WCHAR *ServerIpAddress,
[in] DHCP_CONST LPDHCP_CLIENT_INFO_PB ClientInfo
);
Parameter
[in, optional] ServerIpAddress
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die IP-Adresse oder den Hostnamen des DHCP-Servers darstellt.
[in] ClientInfo
Zeiger auf eine DHCP_CLIENT_INFO_PB-Struktur , die die Informationen zum DHCP-Clientleasingdatensatz enthält. Die Felder ClientIpAddress und ClientHardwareAddress dieser Struktur sind erforderlich, alle anderen sind optional.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes oder einen Fehlercode aus der DHCP-Serververwaltungs-API-Fehlercodes zurück.
| Wert | Bedeutung |
|---|---|
|
Mindestens einer der Parameter war ungültig. |
|
Dieser Aufruf wurde von einem Client ausgeführt, der nicht Mitglied der Sicherheitsgruppe DHCP-Administratoren ist. |
|
Die clientIpAddress , die innerhalb von ClientInfo übergeben wird, entspricht keinem DHCPv4-Bereich, der auf dem DHCP-Server konfiguriert ist. |
|
Der bereitgestellte DHCP-Clientdatensatz ist bereits in der DHCP-Serverdatenbank vorhanden. |
Hinweise
Diese Funktion lässt die Erstellung von Leases nicht zu, wenn kein Bereich vorhanden ist, der der auf dem Server konfigurierten ClientIpAddress entspricht, und gibt stattdessen ERROR_DHCP_SUBNET_NOT_PRESENT zurück. Die angegebene Client-IP-Adresse wird als nicht verfügbar (oder verteilt) markiert, um IP-Konflikte zu vermeiden. Die so markierten Adressen spiegeln sich auch in der Adressstatistik des Bereichs wider.
Im Gegensatz zu DhcpCreateClientInfoVQ verwendet diese Funktion die Felder bClientType, AddressState, Status, ProbationEnds und QuarantineCapable , die beim Erstellen des Leasedatensatzes innerhalb der DHCP_CLIENT_INFO_PB-Struktur an ClientInfo übergeben werden. Außerdem wird das neue Feld PolicyName hinzugefügt, wenn es innerhalb von ClientInfo im neuen Leasedatensatz übergeben wird. Es wird nicht überprüft, ob policyName einer gültigen Richtlinie entspricht, die auf dem DHCP-Server oder dem entsprechenden Bereich konfiguriert ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dhcpsapi.h |
| Bibliothek | Dhcpsapi.lib |
| DLL | Dhcpsapi.dll |