Функция 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, которое будет назначено имени значения, которое ЗначениеName указывает.

Возвращаемое значение

WdfRegistryAssignULong возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае метод может вернуть одно из следующих значений:

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Если имя значения, указанное параметром ValueName, уже существует, WdfRegistryAssignULong обновляет данные значения.

Платформа задает тип данных значения для REG_DWORD.

Дополнительные сведения о объектах раздела реестра см. в разделе Использование реестра в Framework-Based драйверах.

Примеры

Следующий пример кода назначает константу MY_VALUE значению ValueName в указанном разделе реестра.

UNICODE_STRING valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );
status = WdfRegistryAssignULong(
                                Key,
                                &valueName,
                                MY_VALUE
                                );

Требования

См. также

UNICODE_STRING

WdfRegistryAssignMemory

WdfRegistryAssignMultiString

WdfRegistryAssignString

WdfRegistryAssignUnicodeString

WdfRegistryAssignValue