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 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm)