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 오류를 반환합니다.

설명

애플리케이션이 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(액세스 제어 목록)으로 폴더를 보호합니다.

요구 사항