Freigeben über

DhcpGetSubnetInfoVQ-Funktion (dhcpsapi.h)

  • Artikel

Die DhcpGetSubnetInfoVQ-Funktion ruft die Informationen zu einem bestimmten IPv4-Subnetz ab, das auf dem DHCP-Server definiert ist.

Syntax

DWORD DHCP_API_FUNCTION DhcpGetSubnetInfoVQ(
  [in]  DHCP_CONST WCHAR      *ServerIpAddress,
  [in]  DHCP_IP_ADDRESS       SubnetAddress,
  [out] LPDHCP_SUBNET_INFO_VQ *SubnetInfo
);

Parameter

[in] ServerIpAddress

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

[in] SubnetAddress

DHCP_IP_ADDRESS Struktur, die die IPv4-Adresse des Subnetzes enthält, für das die Informationen geändert werden.

[out] SubnetInfo

Eine DHCP_SUBNET_INFO_VQ-Struktur , die die zurückgegebenen Informationen für das Subnetz enthält, die der von SubnetAddress angegebenen IPv4-Adresse entsprechen.

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_DHCP_JET_ERROR
 Fehler beim Zugriff auf die Datenbank des DHCP-Servers.
ERROR_DHCP_SUBNET_NOT_PRESENT
 Das angegebene Subnetz ist auf dem DHCP-Server nicht definiert.
ERROR_INVALID_PARAMETER
 Einer der Parameter stellt einen ungültigen Wert bereit.

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_SUBNET_INFO_VQ