Функция RtlDeleteRegistryValue (wdm.h)

  • Статья

Подпрограмма RtlDeleteRegistryValue удаляет указанное имя записи и связанные значения из реестра по заданному относительному пути.

Синтаксис

NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
  [in] ULONG  RelativeTo,
  [in] PCWSTR Path,
  [in] PCWSTR ValueName
);

Параметры

[in] RelativeTo

Указывает, является ли Path абсолютным путем к реестру или относительно предопределенного пути к ключу, как одно из следующих значений.

Значение Значение
RTL_REGISTRY_ABSOLUTE Путь — это абсолютный путь к реестру.
RTL_REGISTRY_SERVICES Путь относительно \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL Путь относительно \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT Путь относительно \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP Путь относительно \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER Путь относительно \Registry\User\CurrentUser. (Для системного процесса это \Users\. По умолчанию.)
RTL_REGISTRY_HANDLE Указывает, что параметр Path фактически является дескриптором реестра для использования. Это необязательное значение.

[in] Path

Указывает путь к реестру в соответствии со значением RelativeTo . Если задано RTL_REGISTRY_HANDLE, path — это дескриптор, который будет использоваться напрямую.

[in] ValueName

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

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

RtlDeleteRegistryValue возвращает STATUS_SUCCESS, если запись значения была удалена.

Обратите внимание, что если параметр RelativeTo имеет значение RTL_REGISTRY_HANDLE, происходит следующее:

  • В Windows 98/Me и Windows NT 4.0 подпрограмма закрывает указанный дескриптор перед возвратом.
  • В Windows 2000 и более поздних версиях Windows подпрограмма оставляет дескриптор открытым.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlRtlPassive(wdm)

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

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey