Fungsi WdfRegistryAssignULong (wdfregistry.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfRegistryAssignULong menetapkan nilai kata panjang yang tidak ditandatangani tertentu ke nama nilai tertentu dalam registri.
Sintaks
NTSTATUS WdfRegistryAssignULong(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[in] ULONG 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
Nilai ULONG yang akan ditetapkan ke nama nilai yang ditentukan ValueName .
Nilai kembali
WdfRegistryAssignULong mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
WdfRegistryAssignULong tidak dipanggil di IRQL = PASSIVE_LEVEL. |
|
Parameter yang tidak valid ditentukan. |
|
Driver tidak membuka kunci registri dengan akses KEY_SET_VALUE. |
Metode ini juga mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Jika nama nilai yang ditentukan parameter ValueName sudah ada, WdfRegistryAssignULong memperbarui data nilai.
Kerangka kerja mengatur jenis data nilai ke REG_DWORD.
Untuk informasi selengkapnya tentang objek kunci registri, lihat Menggunakan Registri di Driver Framework-Based.
Contoh
Contoh kode berikut menetapkan MY_VALUE konstanta ke nilai ValueName , di bawah kunci registri tertentu.
UNICODE_STRING valueName;
NTSTATUS status;
RtlInitUnicodeString(
&valueName,
L"ValueName"
);
status = WdfRegistryAssignULong(
Key,
&valueName,
MY_VALUE
);
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) |