Функция 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) |