IWiaDevMgr2::GetImageDlg 메서드
IWiaDevMgr2::GetImageDlg 메서드는 사용자가 WIA(Windows Image Acquire) 2.0 디바이스에서 이미지를 획득하고 지정된 파일에 이미지를 쓸 수 있는 하나 이상의 대화 상자를 표시합니다. 이 메서드는 IWiaDevMgr2::SelectDeviceDlg 의 기능을 확장하여 단일 API 호출 내에서 이미지 획득을 캡슐화합니다.
구문
HRESULT GetImageDlg(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[in] HWND hwndParent,
[in] BSTR bstrFolderName,
[in] BSTR bstrFilename,
[in] LONG *plNumFiles,
[in] BSTR **ppbstrFilePaths,
[in, out] IWiaItem2 **ppItem
);
매개 변수
-
lFlags [in]
-
형식: LONG
대화 상자 동작을 지정합니다. 다음 값으로 설정할 수 있습니다.
플래그 의미 0 기본 동작 WIA_DEVICE_DIALOG_USE_COMMON_UI 공급업체에서 제공하는 UI 대신 시스템 UI를 사용합니다. 시스템 UI를 사용할 수 없는 경우 공급업체 UI가 사용됩니다. 두 UI를 모두 사용할 수 없는 경우 함수는 E_NOTIMPL 반환합니다. -
bstrDeviceID [in]
-
형식: BSTR
사용할 스캐너를 지정합니다.
-
hwndParent [in]
-
형식: HWND
이미지 가져오기 대화 상자를 소유하는 창의 핸들입니다.
-
bstrFolderName [in]
-
형식: BSTR
스캔한 파일을 저장하는 이토 폴더의 이름을 지정합니다.
-
bstrFilename [in]
-
형식: BSTR
이미지 데이터를 쓸 파일의 이름을 지정합니다.
-
plNumFiles [in]
-
형식: LONG*
검사할 파일 수에 대한 포인터입니다.
-
ppbstrFilePaths [in]
-
형식: BSTR**
스캔한 파일의 경로 배열에 대한 포인터의 주소입니다. IWiaDevMgr2::GetImageDlg가 호출되기 전에 크기가 0인 배열을 가리키도록 포인터를 초기화합니다. 설명을 참조하세요.
-
ppItem [in, out]
-
형식: IWiaItem2**
이미지를 스캔한 IWiaItem2 에 대한 포인터의 주소입니다.
반환 값
형식: HRESULT
IWiaDevMgr2::GetImageDlg 는 데이터가 성공적으로 전송되면 S_OK 반환하고, 사용자가 대화 상자를 취소하면 S_FALSE 반환하거나, 표준 COM 오류를 반환합니다.
참고
함수가 S_FALSE 반환하는 경우 ppbstrFilePaths 매개 변수가 반드시 비어 있는 것은 아닙니다. 사용자가 취소하면 검사를 완료한 페이지가 ppbstrFilePaths에서 처리되고 반환됩니다. 사용하지 않더라도 배열을 해제해야 합니다. 설명을 참조하세요.
설명
애플리케이션이 bstrDeviceID 매개 변수 값에 대해 NULL을 전달하는 경우 IWiaDevMgr2::GetImageDlg는 사용자가 WIA 2.0 입력 디바이스를 선택할 수 있도록 디바이스 선택 대화 상자를 표시합니다.
애플리케이션에서 디바이스 및 이미지 선택을 사용할 수 있도록 파일 메뉴에서 스캐너에서라는 메뉴 항목을 사용합니다.
ppbstrFilePaths[i]가 가리키는 배열의 각 BSTR에서 SysFreeString을 호출하고 배열 자체에서 CoTaskMemFree를 호출하여 연결된 메모리를 해제합니다. S_FALSE 반환되면 검사 plNumFiles가 가리키는 값이 0이 아닌지 확인합니다. 값이 0이 아닌 경우 사용자가 하나 이상의 페이지를 스캔한 후 취소할 수 있으므로 애플리케이션의 ppbstrFilePaths[i] 리소스를 해제합니다. IWiaDevMgr2::GetImageDlg를 호출하기 전에 plNumFiles를 0으로 초기화합니다. plNumFiles가 0으로 초기화되지 않고 COM 인프라의 오류로 인해 함수가 IWiaDevMgr2::GetImageDlg가 호출되기 전에 S_FALSE 반환하는 경우 plNumFiles에 잘못된 가비지 값이 있습니다.
대화 상자에는 고유한 파일 이름으로 파일을 저장할 수 있도록 bstrFolderName 에 대한 충분한 권한이 있어야 합니다. 사용자 데이터가 포함되어 있으므로 ACL(액세스 제어 목록)으로 폴더를 보호합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|