RegWrite

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

RegWrite, ValueType, RootKey\SubKey [, ValueName, Value]  ; v1.1.21+
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와 같은 약자) 중 하나. 원격 레지스트리에 접근하려면, 다음 예제와 같이 앞에 컴퓨터 이름과 쌍점 (또는 v1.1.21+이면, 정사선)을 배치하십시오: \\workstation01:HKEY_LOCAL_MACHINE

SubKey

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

RootKey\SubKey [v1.1.21+]

RootKey 다음에 바로 정사선 (\)이 따라오면, RootKey 와 SubKey는 하나의 매개변수로 합병됩니다.

ValueName

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

Value

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

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

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

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

ValueType이 REG_DWORD이면, Value는 -2147483648와 4294967295 (0xFFFFFFFF) 사이의 값이어야 합니다.

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

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

REG_BINARY와 REG_MULTI_SZ 값이 64K보다 크면 v1.1.10.01 이후에서만 지원합니다. 예전 버전에서는 64K까지 만 남기고 잘라내 버립니다.

여러 레지스트리나 키를 열람하고 처리하려면, 레지스트리-회돌이의 사용을 고려해 보십시오.

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

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

RegDelete, RegRead, Registry-loop, SetRegView, IniWrite

RegWrite, REG_SZ, HKEY_LOCAL_MACHINE, SOFTWARE\TestKey, MyValueName, Test Value
RegWrite, REG_BINARY, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, 01A9FF77
RegWrite, REG_MULTI_SZ, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, Line1`nLine2

; 또다른 구문 (v1.1.21+ 필요):
RegWrite, REG_SZ, HKEY_LOCAL_MACHINE\SOFTWARE\TestKey, MyValueName, Test Value
RegWrite, REG_BINARY, HKEY_CURRENT_USER\Software\TEST_APP, TEST_NAME, 01A9FF77
RegWrite, REG_MULTI_SZ, HKEY_CURRENT_USER\Software\TEST_APP, TEST_NAME, Line1`nLine2