ZwDeleteKey 함수(wdm.h)
ZwDeleteKey 루틴은 레지스트리에서 열린 키를 삭제합니다.
구문
NTSYSAPI NTSTATUS ZwDeleteKey(
[in] HANDLE KeyHandle
);
매개 변수
[in] KeyHandle
삭제할 레지스트리 키에 대한 핸들입니다. 핸들은 ZwCreateKey 또는 ZwOpenKey를 성공적으로 호출하여 만들어집니다.
반환 값
ZwDeleteKey 는 NTSTATUS 값을 반환합니다. 가능한 반환 값은 다음과 같습니다.
STATUS_SUCCESS
STATUS_ACCESS_DENIED
STATUS_INVALID_HANDLE
STATUS_CANNOT_DELETE (설명 참조)
설명
ZwDeleteKey를 호출하기 전에 지정된 키 아래의 모든 키와 값이 삭제되었는지 확인합니다. 먼저 각 하위 키를 삭제하고 리프 키부터 시작하여 작동합니다.
이 루틴이 성공하려면 DELETE 액세스를 위해 핸들을 열어야 합니다. 자세한 내용은 ZwCreateKey에 대한 DesiredAccess 매개 변수를 참조하세요.
ZwDeleteKey를 호출하면 KeyHandle 매개 변수에 지정된 핸들과 삭제된 키에 대한 다른 모든 핸들이 유효하지 않습니다. ZwDeleteKey를 호출하면 키 핸들이 무효화된 후 ZwClose를 호출하여 키 핸들을 닫아야 합니다.
레지스트리 키 작업에 대한 자세한 내용은 드라이버에서 레지스트리 사용을 참조하세요.
이 함수에 대한 호출이 사용자 모드에서 발생하는 경우 "ZwDeleteKey" 대신 "NtDeleteKey"라는 이름을 사용해야 합니다.
커널 모드 드라이버에서 호출하는 경우 Windows 네이티브 시스템 서비스 루틴의 NtXxx 및 ZwXxx 버전은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. 루틴의 NtXxx 버전과 ZwXxx 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴의 Nt 및 Zw 버전 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm) |