Fungsi WdfRegistryAssignUnicodeString (wdfregistry.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Metode WdfRegistryAssignUnicodeString menetapkan string Unicode tertentu ke nama nilai tertentu dalam registri.

Sintaks

NTSTATUS WdfRegistryAssignUnicodeString(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] PCUNICODE_STRING Value
);

Parameter

[in] Key

Handel ke objek kunci registri yang mewakili kunci registri yang dibuka.

[in] ValueName

Penunjuk ke struktur UNICODE_STRING yang berisi nama nilai.

[in] Value

Penunjuk ke struktur UNICODE_STRING yang berisi string yang akan ditetapkan ke nama nilai yang ditentukan ValueName .

Nilai kembali

WdfRegistryAssignUnicodeString mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryAssignUnicodeString tidak dipanggil di IRQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan.
STATUS_ACCESS_DENIED	Driver tidak membuka kunci registri dengan akses KEY_SET_VALUE.
STATUS_INSUFFICIENT_RESOURCES	Memori tidak cukup untuk menyelesaikan operasi.

Metode ini juga mungkin mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Jika string yang ditentukan parameter Nilai tidak dihentikan NULL, kerangka kerja menambahkan karakter NULL saat menyalin string ke registri.

Jika nama nilai yang ditentukan parameter ValueName sudah ada, WdfRegistryAssignUnicodeString memperbarui data nilai.

Kerangka kerja mengatur jenis data nilai ke REG_SZ.

Untuk informasi selengkapnya tentang objek kunci registri, lihat Menggunakan Registri di Driver Framework-Based.

Contoh

Contoh kode berikut menetapkan string Unicode "String1" ke nilai ValueName , di bawah kunci registri tertentu.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &ustring1,
                     L"String1"
                     );
RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );

status = WdfRegistryAssignUnicodeString(
                                        Key,
                                        &valueName,
                                        &string1
                                        );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfregistry.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)