RegWrite

값을 레지스트리에 씁니다.

New Syntax [v1.1.21+]

RegWrite, ValueType, KeyName , ValueName, Value

매개변수

ValueType

반드시 REG_SZ, REG_EXPAND_SZ, REG_MULTI_SZ, REG_DWORD, 또는 REG_BINARY 중 하나.

KeyName

The full name of the registry key.

This must start with HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CURRENT_USER, HKEY_CLASSES_ROOT, or HKEY_CURRENT_CONFIG (or the abbreviations for each of these, such as HKLM). 원격 레지스트리에 접근하려면, 컴퓨터 이름을 앞에 두고 다음에 쌍점 (또는 [in v1.1.21+]이면, 역사선)을, 다음 예제와 같이 배치하십시오: \\workstation01:HKEY_LOCAL_MACHINE

ValueName

씌여질 값의 이름. 비어 있거나 생략하면, KeyName의 기본값이 사용됩니다. 기본 값은 RegEdit가 "(Default)"로 보여주는 값입니다.

Value

씌여질 값. 생략하면, ValueType에 따라 빈 문자열 또는 0이 기본값입니다. 텍스트가 길면, 계속 섹션을 수단으로 짧은 줄로 가를 수 있습니다. 이렇게 하면 가독성과 유지관리성이 향상됩니다.

Old Syntax

비추천: 이 구문는 새 스크립트에 사용을 추천하지 않습니다. Use the new syntax instead.

RegWrite, ValueType, RootKey, SubKey , ValueName, Value

매개변수

ValueType

반드시 REG_SZ, REG_EXPAND_SZ, REG_MULTI_SZ, REG_DWORD, 또는 REG_BINARY 중 하나.

RootKey

반드시 HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_CURRENT_USER, HKEY_CLASSES_ROOT, 또는 HKEY_CURRENT_CONFIG 중의 하나여야 합니다. (또는 HKLM와 같은 약어). 원격 레지스트리에 접근하려면, 컴퓨터 이름을 앞에 두고 다음에 쌍점 (또는 [in v1.1.21+]이면, 역사선)을, 다음 예제와 같이 배치하십시오: \\workstation01:HKEY_LOCAL_MACHINE

SubKey

서브키의 이름 (예, Software\SomeApplication). SubKey가 존재하지 않으면, (필요하면 그의 조상도 함께) 생성됩니다. SubKey가 비어 있으면, 값은 직접적으로 RootKey에 씌여집니다 (그렇지만 어떤 운영 체제는 HKEY_CURRENT_USER이 최상위 레벨에 쓰는 것을 거부할 수도 있습니다).

ValueName

씌여질 값의 이름. 비어 있거나 생략하면, SubKey의 기본값이 사용됩니다. 기본 값은 RegEdit가 "(Default)"로 보여주는 값입니다.

Value

씌여질 값. 생략하면, ValueType에 따라 빈 문자열 또는 0이 기본값입니다. 텍스트가 길면, 계속 섹션을 수단으로 짧은 줄로 가를 수 있습니다. 이렇게 하면 가독성과 유지관리성이 향상됩니다.

에러 처리

[v1.1.04+]: 이 명령어는 실패하면 예외를 던질 수 있습니다. 더 자세한 정보는 실행시간 에러를 참조하십시오.

ErrorLevel은 문제가 있으면 1, 그렇지 않으면 0이 설정됩니다.

A_LastError는 운영 체제의 GetLastError() 함수의 결과가 설정됩니다.

논평

ValueType이 REG_DWORD이면, Value는 -2147483648와 4294967295 (0xFFFFFFFF) 사이의 값이어야 합니다. In the registry, REG_DWORD values are always expressed as positive decimal numbers. To read it as a negative number with means such as RegRead, convert it to a signed 32-bit integer by using OutputVar := OutputVar << 32 >> 32 or similar.

REG_BINARY 키를 쓸 때, 십육진 문자로 구성된 문자열을 사용하십시오. 예를 들어 REG_BINARY 값이 01,a9,ff,77 이면 문자열 01A9FF77을 사용해 쓸 수 있습니다.

REG_MULTI_SZ 키를 쓸 때, 각 구성요소를 다음 구성요소와 라인피드 문자로 갈라야 합니다 (`n). 마지막 구성요소는 선택적으로 라인피드로 끝나도 됩니다. 빈 구성요소는 허용하지 않습니다. 다른 말로, 두 개의 라인피드를 한 줄에 지정하지 마십시오 (`n`n). 왜냐하면 그렇게 하면 예상보다 더 짧은 값이 레지스트리에 씌여지기 때문입니다.

[v1.1.10.01+]: REG_BINARY and REG_MULTI_SZ values larger than 64K are also supported. 예전 버전에서는 64K까지 만 남기고 잘라내 버립니다.

여러 키와 값에 작동하고 열람하려면, 레지스트리-회돌이의 사용을 고려하십시오.

원격 컴퓨터의 레지스트리에 접근하는 법에 관한 자세한 정보는 레지스트리-회돌이에서 논평을 참조하십시오.

32-비트 스크립트에서 64-비트 섹션의 레지스트리로부터 엔트리를 또는 그 반대로 읽고 쓰려면, SetRegView를 사용하십시오.

RegDelete, RegRead, 레지스트리-회돌이, SetRegView, IniWrite

예제

New syntax vs. old syntax.

Despite the different syntax, both examples have the same effect; that is, they write a string to the registry.

RegWrite, REG_SZ, HKEY_LOCAL_MACHINE\SOFTWARE\TestKey, MyValueName, Test Value
RegWrite, REG_SZ, HKEY_LOCAL_MACHINE, SOFTWARE\TestKey, MyValueName, Test Value

Writes binary data to the registry.

RegWrite, REG_BINARY, HKEY_CURRENT_USER\Software\TEST_APP, TEST_NAME, 01A9FF77

Writes a multi-line string to the registry.

RegWrite, REG_MULTI_SZ, HKEY_CURRENT_USER\Software\TEST_APP, TEST_NAME, Line1`nLine2