DhcpGetSuperScopeInfoV4-Funktion (dhcpsapi.h)

Die DhcpGetSuperScopeInfoV4-Funktion gibt Informationen zum Superscope eines DHCP-Servers zurück.

Syntax

DWORD DhcpGetSuperScopeInfoV4(
  [in]  DHCP_CONST WCHAR         *ServerIpAddress,
  [out] LPDHCP_SUPER_SCOPE_TABLE *SuperScopeTable
);

Parameter

[in] ServerIpAddress

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

[out] SuperScopeTable

DHCP_SUPER_SCOPE_TABLE Struktur, die die zurückgegebenen Informationen für den Überbau des bereitgestellten DHCP-Servers enthält.

Hinweis  

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

 

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
ERROR_ACCESS_DENIED	Dieser Aufruf wurde von einem Client ausgeführt, der nicht Mitglied der Sicherheitsgruppe "DHCP-Administratoren" ist.

Hinweise

Ein Superscope ist die Gruppe aller Subnetze, die auf einem DHCP-Server definiert sind, und daher alle Bereiche zusammen mit den JEWEILS bedienten IP-Adressbereichen. Insgesamt stellt ein Superscope einen vollständigen Satz aller IP-Adressen bereit, die vom DHCP-Server bereitgestellt werden. Die Superscope-Tabelle enthält die IP-Adressen, die den einzelnen Subnetzen zugeordnet sind. Um die ip-Bereiche abzurufen, die von jedem bereitgestellt werden, sollte DhcpGetSubnetInfo für die IP-Adresse aufgerufen werden, die in jeder DHCP_SUPER_SCOPE_TABLE_ENTRY Struktur der Tabelle angegeben ist.

Anforderungen

Anforderung	Wert
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_SUPER_SCOPE_TABLE

DhcpGetSubnetInfo

DhcpSetSuperScopeV4