IScanProfile 인터페이스

IScanProfile 인터페이스는 단일 검색 프로필을 나타내며 애플리케이션이 프로필의 속성을 설정하고 가져올 수 있도록 합니다.

멤버

IScanProfile 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IScanProfile 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IScanProfile 인터페이스에는 이러한 메서드가 있습니다.

방법 Description
GetAllPropIDs 프로필에서 사용 가능한 모든 속성 ID를 가져옵니다.
GetDeviceID 디바이스의 ID를 반환합니다.
GetGUID 프로필의 GUID를 반환합니다.
Getitem 프로필이 연결된 WIA 2.0 항목 범주의 GUID를 가져옵니다.
GetName 프로필의 이름을 가져옵니다.
GetNumPropIDS 프로필의 속성 ID 수를 가져옵니다.
Getproperty 검색 프로필 요소에서 <Properties> 지정된 자식 속성의 값을 가져옵니다.
IsDefault 프로필이 연결된 IWiaItem2 디바이스의 기본 검색 프로필인지 여부를 나타내는 값을 가져옵니다.
RemoveProperty 검사 프로필 요소에서 <Properties> 지정된 자식 속성 목록을 제거합니다.
저장 프로필의 변경 내용을 디스크에 저장합니다.
Setitem 프로필이 연결된 WIA 2.0 항목 범주의 GUID를 설정합니다.
SetName 프로필의 이름을 설정합니다.
Setproperty 검사 프로필 요소에서 <Properties> 지정된 자식 속성의 값을 설정합니다.

 

설명

모든 IWiaItem2 디바이스에는 스캔 프로필이 있을 수 있습니다. 그러나 WIA_CATEGORY_FINISHED_FILE 및 WIA_CATEGORY_ROOT 형식의 IWiaItem2 항목에는 프로필이 있을 수 없습니다.

IScanProfile::Save 메서드를 사용하여 검색 프로필을 저장하면 %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles에 XML 파일로 저장됩니다.

IScanProfile 개체의 인스턴스를 만들려면 IScanProfileMgr::CreateProfile 메서드를 사용합니다. 디스크에 이미 저장된 검사 프로필에 대한 참조를 얻으려면 IScanProfileMgr::OpenProfile 메서드를 사용합니다.

모든 검사 프로필에는 다음과 같은 요소가 <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>있습니다 <Properties>. 디바이스의 기본 프로필에도 요소가 있습니다 <Default> .

프로필을 만든 후에는 <ProfileGUID> 요소 및 <DeviceID> 요소를 변경할 수 없습니다. 프로필을 만든 후 요소 및 요소의 <ProfileName><WiaItem> 값을 변경할 수 있습니다. <Default> 요소를 추가하거나 삭제할 수 있습니다. IScanProfile::SetName, IScanProfile::SetItemIScanProfileMgr::SetDefault 메서드를 사용하여 프로그래밍 방식으로 수행할 수 있습니다. IScanProfileUI::ScanProfileDialog 메서드를 통해 사용자가 이러한 속성을 변경할 수도 있습니다.

요소에 <Properties> 자식이 포함됩니다 <Property> . WIA 2.0 항목 또는 디바이스 속성을 프로필에 추가하려면 다음을 사용합니다. 사용자 고유의 이미지 묵인 자식도 <Property> 개발할 수 있습니다. 이렇게 하면 검색 프로필 스키마를 확장할 수 있습니다. 스키마 확장에 대한 자세한 내용은 사용자 지정 속성, IScanProfile::GetPropertyIScanProfile::SetProperty 정의를 참조하세요.

요구 사항

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

추가 정보

IDispatch

프로필 스키마 검사