IOCTL_SYSENV_ENUM_VARIABLES IOCTL (ntddsysenv.h)

Artikel
02/26/2024

Gibt Informationen zu Systemumgebungsvariablen mithilfe des SysEnv-Geräts zurück.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein boolescher Wert, der angibt, ob Werte eingeschlossen werden sollen.

Länge des Eingabepuffers

Größe von BOOLEAN.

Ausgabepuffer

Ein Zeiger auf einen Puffer, der die Informationen zur Systemumgebungsvariablen enthält. Wenn Werte angefordert wurden, verweist der Puffer auf ein Array von XVARIABLE_NAME_AND_VALUE Strukturen. Gibt andernfalls ein Array von XVARIABLE_NAME-Strukturen zurück.

Der Speicherort des nächsten Eintrags wird durch NextEntryOffset der XVARIABLE_NAME_AND_VALUE und XVARIABLE_NAME bestimmt.

Länge des Ausgabepuffers

Bei der Eingabe die Länge des Ausgabepuffers in Byte. Bei der Ausgabe die Länge der zurückgegebenen Daten in Bytes. Wenn der Eingabepuffer groß genug ist, gibt dieser Wert die In den Ausgabepuffer kopierte Datenmenge an. Wenn der Eingabepuffer zu klein ist, gibt er die erforderliche Pufferlänge an.

Statusblock

Irp->IoStatus.Status wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.