RtlCreateRegistryKey 함수(wdm.h)
RtlCreateRegistryKey 루틴은 지정된 상대 경로를 따라 레지스트리에 키 개체를 추가합니다.
구문
NTSYSAPI NTSTATUS RtlCreateRegistryKey(
[in] ULONG RelativeTo,
[in] PWSTR Path
);
매개 변수
[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\입니다. 기본값입니다.) |
[in] Path
RelativeTo 값에 따라 레지스트리 경로를 지정합니다.
반환 값
RtlCreateRegistryKey 는 키가 만들어지면 STATUS_SUCCESS 반환합니다.
설명
RtlCreateRegistryKey 는 사용자가 지정한 키만 만듭니다. 지정된 키의 경로에 누락된 키를 만들지 않습니다. 경로에 키가 없으면 호출이 실패합니다. 경로의 모든 키가 있는지 확인하려면 경로의 각 키에 대해 RtlCreateRegistryKey 를 한 번 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |