SHRegGetValueFromHKCUHKLM 함수(shlwapi.h)

[이 함수는 더 이상 지원되지 않습니다.]

레지스트리에서 지정된 정보를 가져옵니다. 이 함수는 지정된 하위 키에서 요청된 정보에 대해 검사 HKEY_CURRENT_USER. 정보가 HKEY_CURRENT_USER 하위 트리 아래에 없는 경우 함수는 HKEY_LOCAL_MACHINE 하위 트리에서 동일한 정보를 확인합니다.

구문

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

매개 변수

[in] pwszKey

형식: PCWSTR

레지스트리 키의 경로를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] pwszValue

형식: PCWSTR

키 값을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 값은 NULL일 수 있으며, 이 경우 데이터는 기본값에서 검색됩니다.

[in] srrfFlags

형식: SRRF

SRRF 플래그 상수입니다. 둘 이상의 플래그를 사용하는 경우 비트 OR을 사용하여 결합할 수 있습니다. 이러한 플래그는 반환되는 데이터 형식을 제한하는 데 사용됩니다. 이 값은 0일 수 없습니다.

[out] pdwType

형식: DWORD*

이 함수가 반환될 때 지정된 값에 저장된 데이터 형식을 나타내는 코드를 수신하는 DWORD 에 대한 포인터를 포함합니다. 형식 정보가 필요하지 않은 경우 NULL 로 설정할 수 있습니다. 이 값이 NULL이 아니고 SRRF_NOEXPAND 플래그가 설정되지 않은 경우 REG_EXPAND_SZ 데이터 형식은 이 메서드에서 자동으로 확장되므로 REG_SZ 반환됩니다.

[in] pvData

형식: LPCVOID

값의 데이터가 포함된 버퍼에 대한 포인터입니다. 데이터가 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다. 이 값은 항목에 있는 pvData 버퍼의 크기를 포함해야 합니다. pvData가 NULL이거나 pvData가 NULL이 아니지만 레지스트리 데이터를 보유하기에 버퍼가 너무 작은 경우 종료 시 레지스트리 데이터를 보유하는 데 필요한 크기가 포함됩니다.

[in, out] pcbData

형식: DWORD*

이 함수가 반환되면 데이터 크기에 대한 포인터(바이트)가 포함됩니다.

반환 값

형식: LONG

성공하면 이 함수는 ERROR_SUCCESS 및 요청된 모든 out 매개 변수를 반환합니다. 제공된 비 NULL pvData의 공간 부족으로 인해 함수가 실패하는 경우 ERROR_MORE_DATA 반환합니다. 이 경우 pdwType 및 pcbData 만 유효한 데이터를 포함할 수 있으며 pvData 는 정의되지 않습니다. 그렇지 않으면 은 Winerror.h 에 정의된 0이 아닌 오류 코드를 반환합니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반 설명을 검색할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
DLL	Shlwapi.dll