DhcpAddServer-Funktion (dhcpsapi.h)

Die DhcpAddServer-Funktion versucht, der vorhandenen Liste der DHCP-Server, die im Domänenverzeichnisdienst verwaltet werden, einen neuen Server hinzuzufügen. Wenn der angegebene DHCP-Server bereits im Verzeichnisdienst vorhanden ist, wird ein Fehler zurückgegeben.

Syntax

DWORD DhcpAddServer(
  [in] DWORD              Flags,
  [in] LPVOID             IdInfo,
  [in] LPDHCP_SERVER_INFO NewServer,
  [in] LPVOID             CallbackFn,
  [in] LPVOID             CallbackData
);

Parameter

[in] Flags

Für die zukünftige Verwendung reserviert. Dieses Feld sollte auf 0x00000000 festgelegt werden.

[in] IdInfo

Zeiger auf eine Adresse, die den ID-Block des Servers enthält. Dieses Feld sollte auf NULL festgelegt werden.

[in] NewServer

Zeiger auf eine DHCP_SERVER_INFO-Struktur , die Informationen zum neuen DHCP-Server enthält. Die in dieser Struktur vorhandenen DsLocation - und DsLocType-Member sind in dieser Implementierung ungültig und sollten auf NULL festgelegt werden. Der Versionsmember dieser Struktur sollte auf 0 festgelegt werden.

[in] CallbackFn

Zeiger auf die Rückruffunktion, die aufgerufen wird, wenn der Server-Add-Vorgang abgeschlossen ist. Dieses Feld sollte NULL sein.

[in] CallbackData

Zeiger auf einen Datenblock, der die formatierte Struktur für Rückrufinformationen enthält. Dieses Feld sollte NULL 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.

Anforderungen

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

Weitere Informationen

DHCP_SERVER_INFO

DhcpDeleteServer