ORSetValue 함수

오프라인 레지스트리 하이브에서 지정된 레지스트리 키 값에 대한 데이터를 설정합니다.

구문

DWORD ORSetValue(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpValueName,
  _In_     DWORD  dwType,
  _In_opt_ const BYTE *lpData,
  _In_     DWORD  cbData
);

매개 변수

핸들 [in]

오프라인 레지스트리 하이브에서 열린 레지스트리 키에 대한 핸들입니다.

lpValueName [in, optional]

설정할 값의 이름입니다. 이 이름의 값이 키에 아직 없는 경우 함수는 키에 추가합니다.

lpValueName이 NULL이거나 빈 문자열 ""인 경우 함수는 키의 명명되지 않은 값 또는 기본값에 대한 형식과 데이터를 설정합니다.

자세한 내용은 레지스트리 요소 크기 제한을 참조하세요.

레지스트리 키에는 기본값이 없지만 명명되지 않은 값이 하나 있을 수 있습니다. 이 값은 모든 형식일 수 있습니다.

dwType [in]

lpData 매개 변수가 가리키는 데이터 형식입니다. 가능한 형식 목록은 레지스트리 값 형식을 참조하세요.

lpData [in, optional]

저장할 데이터입니다.

REG_SZ 같은 문자열 기반 형식의 경우 문자열은 null로 종료되어야 합니다. REG_MULTI_SZ 데이터 형식의 경우 문자열을 두 개의 null 문자로 종료해야 합니다.

cbData [in]

lpData 매개 변수가 가리키는 정보의 크기(바이트)입니다. 데이터가 REG_SZ, REG_EXPAND_SZ 또는 REG_MULTI_SZ 형식인 경우 cbData 는 종료되는 null 문자 또는 문자의 크기를 포함해야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.

설명

값 크기는 사용 가능한 메모리에 의해 제한됩니다. 긴 값(2048바이트 이상)은 레지스트리에 저장된 파일 이름을 가진 파일로 저장해야 합니다. 이렇게 하면 레지스트리가 효율적으로 수행됩니다. 아이콘, 비트맵 및 실행 파일과 같은 애플리케이션 요소는 파일로 저장되어야 하며 레지스트리에 배치되지 않아야 합니다.

요구 사항

요구 사항	값
재배포 가능 파일	Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상
헤더	Offreg.h
DLL	Offreg.dll

추가 정보

ORCreateKey

OROpenKey