Функция WdfRegistryQueryULong (wdfregistry.h)

  • Статья

[Относится к KMDF и UMDF]

Метод WdfRegistryQueryULong извлекает данные без знака длинного слова (REG_DWORD), которые в настоящее время назначены указанному значению реестра, и копирует данные в указанное расположение.

Синтаксис

NTSTATUS WdfRegistryQueryULong(
  [in]  WDFKEY           Key,
  [in]  PCUNICODE_STRING ValueName,
  [out] PULONG           Value
);

Параметры

[in] Key

Дескриптор для объекта раздела реестра, представляющего открытый раздел реестра.

[in] ValueName

Указатель на структуру UNICODE_STRING , содержащую имя для значения реестра.

[out] Value

Указатель на расположение, которое получает данные, назначенные значению реестра, заданному ValueName .

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

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

Код возврата Описание
STATUS_INVALID_DEVICE_REQUEST

WdfRegistryQueryULong не был вызван в IRQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER
 Указан недопустимый параметр.
STATUS_INSUFFICIENT_RESOURCES
 Недостаточно памяти для завершения операции.
STATUS_ACCESS_DENIED
 Драйвер не открывал раздел реестра с доступом KEY_QUERY_VALUE, KEY_READ или KEY_ALL_ACCESS.
STATUS_OBJECT_TYPE_MISMATCH
 Тип данных значения реестра, указанного параметром ValueName , не был REG_DWORD.
STATUS_OBJECT_NAME_NOT_FOUND
 Значение реестра недоступно.
 

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

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

Комментарии

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

Примеры

В следующем примере кода извлекаются данные, которые в настоящее время назначены значению NumberOfThings .

NTSTATUS  status;
ULONG  value;
DECLARE_CONST_UNICODE_STRING(valueName, L"NumberOfThings");

status = WdfRegistryQueryULong(
                               hKey,
                               &valueName,
                               &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)

См. также раздел

UNICODE_STRING

WdfRegistryQueryMemory

WdfRegistryQueryMultiString

WdfRegistryQueryString

WdfRegistryQueryUnicodeString

WdfRegistryQueryValue