wiasReadPropStr 함수(wiamdef.h)
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 |