IScanProfile::SetProperty 메서드

  • 아티클

검사 프로필의 요소에서 <Properties> 지정된 자식 속성의 값을 설정합니다.

구문

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

매개 변수

num [in]

형식: ULONG

pid 및 pvar에서 가리키는 배열의 항목 수입니다.

pid [in]

형식: PROPID*

설정할 속성의 ID 번호 배열에 대한 포인터입니다. 배열의 각 값은 WIA 속성 상수입니다.

pvar [in]

형식: PROPVARIANT*

속성에 할당할 값 배열에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

pid가 가리키는 배열의 각 값은 WIA 속성 상수 중 하나입니다. 이 식별 시스템을 확장할 수 있습니다. 사용자 지정 속성 정의를 참조하세요.

애플리케이션이 IScanProfile::Save 메서드를 호출할 때까지 프로필에 대한 변경 내용은 디스크에 저장되지 않습니다.

두 애플리케이션이 동일한 XML 파일에서 스캔 프로필 개체를 만들고 각 애플리케이션이 해당 개체에 변경 내용을 쓰는 경우 IScanProfile::Save last을 호출하는 애플리케이션의 변경 내용만 디스크에 저장됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
헤더
Scanprofile.h
IDL
Scanprofiles.idl

추가 정보

IScanProfile

개념

프로필 스키마 검사

WIA 속성 상수

사용자 지정 속성 정의