DhcpGetClassInfo-Funktion (dhcpsapi.h)

Die DhcpGetClassInfo-Funktion gibt die Benutzer- oder Anbieterklasseninformationen zurück, die auf einem bestimmten DHCP-Server konfiguriert sind.

Syntax

DWORD DhcpGetClassInfo(
  [in]  LPWSTR            ServerIpAddress,
  [in]  DWORD             ReservedMustBeZero,
  [in]  LPDHCP_CLASS_INFO PartialClassInfo,
  [out] LPDHCP_CLASS_INFO *FilledClassInfo
);

Parameter

[in] ServerIpAddress

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

[in] ReservedMustBeZero

Reserviert. Dieser Parameter muss auf 0 festgelegt werden.

[in] PartialClassInfo

DHCP_CLASS_INFO Struktur, die vom Aufrufer bereitgestellte Daten für die folgenden Member enthält, wobei alle anderen Felder initialisiert sind.

• ClassName
• ClassData
• ClassDataLength

Diese Felder dürfen nicht NULL sein.

[out] FilledClassInfo

DHCP_CLASS_INFO Nachschlagevorgang zurückgegebene Struktur, die die vollständigen Klasseninformationen 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_INVALID_PARAMETER	Die inPartialClassInfo bereitgestellte DHCP_CLASS_INFO-Struktur weist NULL- oder Nullwerte für mindestens eines der erforderlichen Member auf.
ERROR_DHCP_CLASS_NOT_FOUND	Es wurde kein Klassenname gefunden, der den bereitgestellten Informationen entspricht.

Hinweise

Eine DHCP-Klasse ist eine bestimmte Clientkategorie, die entweder vom Anbieter oder von einem Benutzer definiert wird. Ein Beispiel für eine vom Anbieter definierte Klasse wären alle Windows 8-Clients mit Microsoft als Anbieter. Eine benutzerdefinierte Klasse besteht aus clients mit bestimmten Attributen, die von einem Benutzer oder Administrator ausgewählt wurden, z. B. alle Laptops oder Clients, die drahtlose Verbindungen unterstützen.

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_CLASS_INFO

DhcpCreateClass