RtlWriteRegistryValue 함수(wdm.h)
RtlWriteRegistryValue 루틴은 지정된 값 이름의 지정된 상대 경로를 따라 호출자가 제공한 데이터를 레지스트리에 씁니다.
구문
NTSYSAPI NTSTATUS RtlWriteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName,
[in] ULONG ValueType,
[in, optional] PVOID ValueData,
[in] ULONG ValueLength
);
매개 변수
[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_OPTIONAL | 이 매개 변수 및 Path 매개 변수에서 참조하는 키가 선택 사항임을 지정합니다. |
| RTL_REGISTRY_HANDLE | Path 매개 변수가 실제로 사용할 레지스트리 핸들임을 지정합니다. 이 값은 선택 사항입니다. |
[in] Path
RelativeTo 매개 변수로 지정된 알려진 위치를 기준으로 절대 레지스트리 경로 또는 경로에 대한 포인터입니다. RTL_REGISTRY_HANDLE 플래그를 지정하면 이 매개 변수는 이미 열려 있는 키를 직접 사용할 레지스트리 핸들입니다.
[in] ValueName
레지스트리에 쓸 하위 키 또는 값 항목의 이름에 대한 포인터입니다.
[in] ValueType
ValueName 매개 변수의 형식을 결정하는 REG_XXX 값을 지정합니다. 가능한 값 목록은 ZwSetValueKey의 Type 매개 변수를 참조하세요.
[in, optional] ValueData
레지스트리에 쓸 값 항목(또는 둘 다)의 하위 키 이름 또는 값에 대한 포인터입니다.
[in] ValueLength
레지스트리에 쓸 ValueData 의 바이트 수를 지정합니다.
반환 값
RtlWriteRegistryValue는 STATUS_SUCCESS 또는 오류 상태 작업의 상태 반환합니다.
설명
지정된 키가 없으면 루틴에서 키를 만들려고 시도합니다. 이 시도가 성공하려면 새 키가 Path 매개 변수에서 참조하는 키의 직접 하위 키여야 하며 Path에서 참조 하는 키는 KEY_CREATE_SUB_KEY 액세스를 위해 열려 있어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |