RtlWriteRegistryValue 함수(wdm.h)

아티클
02/27/2024

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