ResUtilGetDwordProperty 함수(resapi.h)

속성 목록에서DWORD 속성을 검색하고 목록의 다음 속성에 대한 포인터를 진행합니다. PRESUTIL_GET_DWORD_PROPERTY 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD ResUtilGetDwordProperty(
  [out] LPDWORD               pdwOutValue,
  [in]  const PCLUSPROP_DWORD pValueStruct,
  [in]  DWORD                 dwOldValue,
  [in]  DWORD                 dwMinimum,
  [in]  DWORD                 dwMaximum,
  [out] LPBYTE                *ppPropertyList,
  [out] LPDWORD               pcbPropertyListSize
);

매개 변수

[out] pdwOutValue

속성 목록의 DWORD 값이 반환되는 포인터의 주소입니다.

[in] pValueStruct

속성 목록에서 검색할 DWORD 값을 지정하는 CLUSPROP_DWORD 구조체에 대한 포인터입니다.

[in] dwOldValue

속성의 이전 값을 지정합니다.

[in] dwMinimum

속성에 허용되는 최소값을 지정합니다.

[in] dwMaximum

속성에 허용되는 최대값을 지정합니다.

[out] ppPropertyList

DWORD 속성을 포함하는 속성 목록 버퍼에 대한 포인터의 주소입니다. 이 포인터는 다음 속성의 시작 부분으로 진행됩니다.

[out] pcbPropertyListSize

속성 목록 버퍼의 크기에 대한 포인터입니다. 크기는 ppPropertyList 포인터의 진행을 고려하여 감소됩니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.

작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드입니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	데이터의 형식이 잘못되었습니다.

설명

ResUtilGetDwordProperty 유틸리티 함수는 pdwOutValue에서 반환된 값이 dwMinimum 및 dwMaximum에 지정된 범위 내에 있는지 확인합니다. dwMinimum 및 dwMaximum이 모두 0으로 설정된 경우 범위 검사가 수행되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼	Windows
헤더	resapi.h
라이브러리	ResUtils.lib
DLL	ResUtils.dll