ExSetFirmwareEnvironmentVariable-Funktion (wdm.h)

Artikel
02/27/2024

Die ExSetFirmwareEnvironmentVariable-Routine legt den Wert der angegebenen Umgebungsvariable der Systemfirmware fest.

Syntax

NTSTATUS ExSetFirmwareEnvironmentVariable(
  [in] PUNICODE_STRING VariableName,
  [in] LPGUID          VendorGuid,
  [in] PVOID           Value,
  [in] ULONG           ValueLength,
  [in] ULONG           Attributes
);

Parameter

[in] VariableName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Namen der angegebenen Umgebungsvariablen enthält.

[in] VendorGuid

Ein Zeiger auf eine GUID, die den Anbieter identifiziert, der der angegebenen Umgebungsvariablen zugeordnet ist. Umgebungsvariablen werden basierend auf ihren Anbieter-GUIDs in Namespaces gruppiert. Einige Hardwareplattformen unterstützen möglicherweise keine ANBIETER-GUIDs. Auf diesen Plattformen werden alle Variablen in einem gemeinsamen Namespace gruppiert, und der VendorGuid-Parameter wird ignoriert.

[in] Value

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der den Datenwert enthält, der in die angegebene Umgebungsvariable geschrieben werden soll.

[in] ValueLength

Die Größe des im Wertpuffer enthaltenen Datenwerts in Bytes.

[in] Attributes

Die Attribute, die der angegebenen Umgebungsvariablen zugewiesen werden sollen. Das VARIABLE_ATTRIBUTE_NON_VOLATILE-Attributbit muss festgelegt werden, andernfalls schlägt dieser Aufruf fehl. Weitere Informationen zu den Attributbits, die für diesen Parameter definiert sind, finden Sie unter Hinweise in ExGetFirmwareEnvironmentVariable.

Rückgabewert

ExSetFirmwareEnvironmentVariable gibt bei erfolgreicher Ausführung STATUS_SUCCESS zurück. Mögliche Rückgabewerte sind der folgende Fehler status Codes.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Die verfügbaren Systemressourcen reichen nicht aus, um den angeforderten Vorgang abzuschließen.
STATUS_INVALID_PARAMETER	Einer der Parameter ist ungültig.
STATUS_NOT_IMPLEMENTED	Diese Routine wird auf dieser Plattform nicht unterstützt.
STATUS_UNSUCCESSFUL	Die Firmware hat einen unbekannten Fehler zurückgegeben.

Hinweise

Der Aufrufer benötigt die Systemumgebungsberechtigung (SE_SYSTEM_ENVIRONMENT_PRIVILEGE), um diese Routine verwenden zu können.

Umgebungsvariablen der Systemfirmware enthalten Datenwerte, die zwischen der in der Hardwareplattform implementierten Startfirmwareumgebung und den Betriebssystemladeprogrammen und anderer Software übergeben werden, die in der Firmwareumgebung ausgeführt wird. Weitere Informationen finden Sie unter Hinweise in ExGetFirmwareEnvironmentVariable.

Wenn Sie einen Sicherungsdatenspeicher erstellen, können Sie die ExGetFirmwareEnvironmentVariable-Routine verwenden, um alle Starteinstellungen für die Plattform zu speichern. Später können Sie exSetFirmwareEnvironmentVariable verwenden, um diese Einstellungen bei Bedarf wiederherzustellen.

ExSetFirmwareEnvironmentVariable ist die Kernelmodus-Entsprechung der Win32 SetFirmwareEnvironmentVariable-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

ExGetFirmwareEnvironmentVariable

SetFirmwareEnvironmentVariable

UNICODE_STRING

Freigeben über