Fungsi ExSetFirmwareEnvironmentVariable (wdm.h)

Artikel
02/27/2024

Rutinitas ExSetFirmwareEnvironmentVariable menetapkan nilai variabel lingkungan firmware sistem yang ditentukan.

Sintaks

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

Parameter

[in] VariableName

Penunjuk ke struktur UNICODE_STRING yang berisi nama variabel lingkungan yang ditentukan.

[in] VendorGuid

Pointer ke GUID yang mengidentifikasi vendor yang terkait dengan variabel lingkungan yang ditentukan. Variabel lingkungan dikelompokkan ke dalam namespace berdasarkan GUID vendor mereka. Beberapa platform perangkat keras mungkin tidak mendukung GUID vendor. Pada platform ini, semua variabel dikelompokkan ke dalam satu, namespace umum, dan parameter VendorGuid diabaikan.

[in] Value

Penunjuk ke buffer yang dialokasikan pemanggil yang berisi nilai data untuk ditulis ke variabel lingkungan yang ditentukan.

[in] ValueLength

Ukuran, dalam byte, dari nilai data yang terkandung dalam buffer Nilai .

[in] Attributes

Atribut yang akan ditetapkan ke variabel lingkungan yang ditentukan. Bit atribut VARIABLE_ATTRIBUTE_NON_VOLATILE harus diatur atau panggilan ini akan gagal. Untuk informasi selengkapnya tentang bit atribut yang ditentukan untuk parameter ini, lihat Keterangan di ExGetFirmwareEnvironmentVariable.

Nilai kembali

ExSetFirmwareEnvironmentVariable mengembalikan STATUS_SUCCESS jika berhasil. Nilai yang mungkin dikembalikan termasuk kode status kesalahan berikut.

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Sumber daya sistem yang tersedia tidak cukup untuk menyelesaikan operasi yang diminta.
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid.
STATUS_NOT_IMPLEMENTED	Rutinitas ini tidak didukung pada platform ini.
STATUS_UNSUCCESSFUL	Firmware mengembalikan kesalahan yang tidak dikenal.

Keterangan

Pemanggil memerlukan hak istimewa lingkungan sistem (SE_SYSTEM_ENVIRONMENT_PRIVILEGE) untuk menggunakan rutinitas ini.

Variabel lingkungan firmware sistem berisi nilai data yang diteruskan antara lingkungan firmware boot yang diterapkan di platform perangkat keras dan loader sistem operasi dan perangkat lunak lain yang berjalan di lingkungan firmware. Untuk informasi selengkapnya, lihat Keterangan di ExGetFirmwareEnvironmentVariable.

Jika Anda membuat datastore cadangan, Anda dapat menggunakan rutinitas ExGetFirmwareEnvironmentVariable untuk menyimpan semua pengaturan boot untuk platform. Nantinya, Anda dapat menggunakan ExSetFirmwareEnvironmentVariable untuk memulihkan pengaturan ini jika diperlukan.

ExSetFirmwareEnvironmentVariable setara dengan fungsi Win32 SetFirmwareEnvironmentVariable .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Lihat juga

ExGetFirmwareEnvironmentVariable

SetFirmwareEnvironmentVariable

UNICODE_STRING

Bagikan melalui