Функция WdfRegistryAssignULong (wdfregistry.h)
[Применимо к KMDF и UMDF]
Метод WdfRegistryAssignULong назначает указанное значение длинного слова без знака указанному имени значения в реестре.
Синтаксис
NTSTATUS WdfRegistryAssignULong(
[in] WDFKEY Key,
[in] PCUNICODE_STRING ValueName,
[in] ULONG Value
);
Параметры
[in] Key
Дескриптор для объекта раздела реестра, представляющего открытый раздел реестра.
[in] ValueName
Указатель на структуру UNICODE_STRING , содержащую имя значения.
[in] Value
Значение ULONG, которое будет присвоено имени значения, указанного значением ValueName .
Возвращаемое значение
WdfRegistryAssignULong возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае метод может вернуть одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
WdfRegistryAssignULong не был вызван в IRQL = PASSIVE_LEVEL. |
|
Указан недопустимый параметр. |
|
Драйвер не открыл раздел реестра с KEY_SET_VALUE доступом. |
Этот метод также может возвращать другие значения NTSTATUS.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Если имя значения, указанное в параметре ValueName , уже существует, WdfRegistryAssignULong обновляет данные значения.
Платформа задает тип данных значения в REG_DWORD.
Дополнительные сведения об объектах раздела реестра см. в разделе Использование реестра в Framework-Based Drivers.
Примеры
В следующем примере кода константный MY_VALUE назначается значению ValueName в указанном разделе реестра.
UNICODE_STRING valueName;
NTSTATUS status;
RtlInitUnicodeString(
&valueName,
L"ValueName"
);
status = WdfRegistryAssignULong(
Key,
&valueName,
MY_VALUE
);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Минимальная версия UMDF | 2,0 |
| Верхняя часть | wdfregistry.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |