wiasGetPropertyAttributes 함수(wiamdef.h)

wiasGetPropertyAttributes 함수는 속성 집합에 대한 액세스 플래그 및 유효한 값을 검색합니다.

구문

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

매개 변수

[in] pWiasContext

WIA 항목 컨텍스트에 대한 포인터입니다.

cPropSpec

속성 수를 지정합니다.

[in] pPropSpec

유효한 값 및 액세스 플래그를 가져올 속성을 나타내는 PROPSPEC 구조체에 대한 포인터입니다.

pulAccessFlags

속성에 대한 액세스 플래그를 포함하는 배열에 대한 포인터입니다.

[out] pPropVar

속성에 유효한 값을 포함하는 PROPVARIANT 구조체의 배열에 대한 포인터입니다.

반환 값

성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나를 반환합니다.

설명

이 함수는 pPropVar 배열의 각 요소를 해당 속성의 유효한 값을 지정하는 PROPVARIANT 구조체로 채웁니다. 액세스 권한 플래그가 WIA_PROP_NONE 속성에는 해당 속성에 대한 유효한 값이 없습니다. 이러한 속성의 유효한 값에 대한 데이터 형식은 VT_EMPTY.

pulAccessFlags 배열의 각 요소에서 하나 이상의 WIA_PROP_Xxx 속성 특성 및 액세스 플래그를 반환할 수 있습니다.

속성에 유효한 값 범위가 있는 경우 이 함수가 완료되면 pPropVar 매개 변수를 통해 값을 확인할 수 있습니다. pPropVar 매개 변수는 PROPVARIANT 구조체의 배열을 지정합니다.

범위의 유효한 정수 및 부동 소수점 값은 다음 인덱스 상수를 사용하여 액세스합니다.

유효한 값 인덱스	Description
WIA_RANGE_MIN	최소값
WIA_RANGE_NOM	명목 값
WIA_RANGE_MAX	최대값
WIA_RANGE_STEP	증분 값

유효한 목록 값은 다음 인덱스 상수를 사용하여 액세스됩니다.

유효한 값 인덱스	Description
WIA_LIST_COUNT	명목 값을 계산하지 않고 유효한 목록 값의 수
WIA_LIST_NOM	명목 값
WIA_LIST_VALUES	첫 번째 유효한 값에 대한 인덱스

유효한 비트 플래그 값은 다음 인덱스 상수를 사용하여 액세스됩니다.

유효한 값 인덱스	Description
WIA_FLAG_NOM	명목 값
WIA_FLAG_VALUES	모든 유효한 플래그는 OR 연산자가 함께 조인합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	wiamdef.h(Wiamdef.h 포함)
라이브러리	Wiaservc.lib
DLL	Wiaservc.dll