ORGetValue 함수
오프라인 레지스트리 하이브에서 지정된 레지스트리 값에 대한 형식 및 데이터를 검색합니다.
구문
DWORD ORGetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKey,
_In_opt_ PCWSTR lpValue,
_Out_opt_ PDWORD pdwType,
_Out_opt_ PVOID pvData,
_Inout_opt_ PDWORD pcbData
);
매개 변수
-
핸들 [in]
-
오프라인 레지스트리 하이브에서 열린 레지스트리 키에 대한 핸들입니다.
-
lpSubKey [in, optional]
-
레지스트리 키의 이름입니다. 이 키는 Handle 매개 변수로 지정된 키의 하위 키여야 합니다. 이 매개 변수는 NULL일 수 있습니다.
키 이름은 대/소문자를 구분하지 않습니다.
-
lpValue [in, optional]
-
레지스트리 값의 이름입니다. 이 매개 변수가 NULL 이거나 빈 문자열 ""인 경우 함수는 키의 명명되지 않은 값 또는 기본값(있는 경우)에 대한 형식과 데이터를 검색합니다. 자세한 내용은 레지스트리 요소 크기 제한을 참조하세요.
키에는 명명되지 않은 값이나 기본값이 자동으로 없습니다. 명명되지 않은 값은 모든 형식일 수 있습니다.
값 이름은 대/소문자를 구분하지 않습니다.
-
pdwType [out, optional]
-
지정된 값에 저장된 데이터 형식을 나타내는 코드를 수신하는 변수에 대한 포인터입니다. 가능한 형식 코드 목록은 레지스트리 값 형식을 참조하세요. 형식이 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.
-
pvData [out, optional]
-
값의 데이터를 수신하는 버퍼에 대한 포인터입니다. 데이터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.
데이터가 문자열인 경우 함수는 종료되는 null 문자를 확인합니다. 버퍼가 추가 문자를 수용할 수 있을 만큼 큰 경우 문자열이 null 종결자와 함께 저장됩니다. 그렇지 않으면 함수가 실패하고 ERROR_MORE_DATA 반환합니다.
-
pcbData [in, out, optional]
-
pvData 매개 변수가 가리키는 버퍼의 크기를 바이트 단위로 지정하는 변수에 대한 포인터입니다. 함수가 반환되면 이 변수에는 pvData에 복사된 데이터의 크기가 포함됩니다.
pcbData 매개 변수는 pvData가 NULL인 경우에만 NULL일 수 있습니다.
데이터에 REG_SZ, REG_MULTI_SZ 또는 REG_EXPAND_SZ 형식이 있는 경우 이 크기에는 종료되는 null 문자 또는 문자가 포함됩니다. 자세한 내용은 설명 부분을 참조하세요.
pvData 매개 변수로 지정된 버퍼가 데이터를 저장할 만큼 크지 않은 경우 함수는 ERROR_MORE_DATA 반환하고 pcbData가 가리키는 변수에 필요한 버퍼 크기를 저장합니다. 이 경우 pvData 버퍼의 내용은 정의되지 않습니다.
pvData가 NULL이고 pcbData가 NULL이 아닌 경우 함수는 ERROR_SUCCESS 반환하고 데이터의 크기를 pcbData가 가리키는 변수에 바이트 단위로 저장합니다. 이렇게 하면 애플리케이션이 값의 데이터에 버퍼를 할당하는 가장 좋은 방법을 결정할 수 있습니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.
설명
애플리케이션은 일반적으로 OREnumValue 함수를 호출하여 값 이름을 확인한 다음 ORGetValue 함수를 호출하여 이름에 대한 데이터를 검색합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 재배포 가능 파일 |
Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상 |
| 헤더 |
|
| DLL |
|
추가 정보