DhcpUndoRequestParams-Funktion (dhcpcsdk.h)

Die DhcpUndoRequestParams-Funktion entfernt persistente Anforderungen, die zuvor mit einem DhcpRequestParams-Funktionsaufruf vorgenommen wurden.

Syntax

DWORD DhcpUndoRequestParams(
  [in] DWORD  Flags,
  [in] LPVOID Reserved,
  [in] LPWSTR AdapterName,
  [in] LPWSTR RequestIdStr
);

Parameter

[in] Flags

Reserviert. Muss Null sein.

[in] Reserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

[in] AdapterName

GUID des Adapters, für den keine Informationen mehr erforderlich sind. Muss unter 256 Zeichen sein.

Hinweis Dieser Parameter wird nicht mehr verwendet.

 

[in] RequestIdStr

Anwendungsbezeichner (ID), die ursprünglich verwendet wurde, um eine persistente Anforderung zu stellen. Diese Zeichenfolge muss mit dem RequestIdStr-Parameter übereinstimmen, der im DhcpRequestParams-Funktionsaufruf verwendet wird, der die entsprechende persistente Anforderung abgerufen hat. Beachten Sie, dass dies mit der zuvor verwendeten Anwendungs-ID übereinstimmen muss und eine druckbare Zeichenfolge ohne Sonderzeichen sein muss (Kommas, umgekehrte Schrägstriche, Doppelpunkte oder andere ungültige Zeichen dürfen nicht verwendet werden).

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. Andernfalls wird ein Windows-Fehlercode zurückgegeben.

Hinweise

Persistente Anforderungen werden in der Regel durch den Setup- oder Installationsprozess gestellt, der der Anwendung zugeordnet ist. Wenn dies angebracht ist, führt der Setup- oder Installationsprozess wahrscheinlich dazu, dass die DhcpUndoRequestParams-Funktion aufgerufen wird, um die zugeordnete persistente Anforderung abzubrechen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dhcpcsdk.h
Bibliothek	Dhcpcsvc.lib
DLL	Dhcpcsvc.dll

Weitere Informationen

DHCP-Funktionen

DhcpCApiInitialize

DhcpRequestParams