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 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm) |