wiasReadPropStr 함수(wiamdef.h)

아티클
02/06/2022
읽는 데 2분 걸림

wiasReadPropStr 함수는 WIA 항목에서 문자열 속성 값을 검색합니다.

구문

HRESULT wiasReadPropStr(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BSTR   *pbstr,
  [out, optional] BSTR   *pbstrOld,
                  BOOL   bMustExist
);

매개 변수

[in] pWiasContext

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

propid

속성 식별자를 지정합니다.

[out] pbstr

속성 문자열 값의 첫 번째 바이트를 받는 메모리 위치에 대한 포인터입니다.

[out, optional] pbstrOld

속성의 이전 값 중 첫 번째 바이트를 받는 메모리 위치에 대한 포인터입니다. 이 정보가 필요하지 않은 경우 이 매개 변수를 NULL로 설정합니다.

bMustExist

속성이 있어야 하는지 여부를 나타냅니다. TRUE로 설정하면 속성이 있어야 합니다. FALSE로 설정하면 속성이 존재하지 않아도됩니다.

반환 값

성공하면 함수는 S_OK 반환합니다. 함수가 실패하면 표준 COM 오류 또는 WIA_ERROR_XXX 오류 중 하나가 반환됩니다(Microsoft Windows SDK 설명서에 설명되어 있음).

설명

이 함수에서 받은 문자열을 사용하여 미니 드라이버가 완료되면 문자열에 사용되는 메모리의 할당을 취소해야 합니다.

요구 사항


지원되는 최소 클라이언트	Microsoft Windows Me 및 Windows XP 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	wiamdef.h(Wiamdef.h 포함)
라이브러리	Wiaservc.lib
DLL	Wiaservc.dll

참고 항목

wiasReadPropStr 함수(wiamdef.h)

구문

매개 변수

반환 값

설명

요구 사항

참고 항목

피드백