IWiaDevMgr::RegisterEventCallbackProgram 메서드(wia_xp.h)

IWiaDevMgr::RegisterEventCallbackProgram 메서드는 디바이스 이벤트를 수신하도록 애플리케이션을 등록합니다. WIA용으로 작성되지 않은 애플리케이션과의 이전 버전과의 호환성을 위해 주로 제공됩니다.

구문

HRESULT RegisterEventCallbackProgram(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] BSTR       bstrCommandline,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

매개 변수

[in] lFlags

형식: LONG

등록 플래그를 지정합니다. 다음 값으로 설정할 수 있습니다.

등록 플래그	의미
WIA_REGISTER_EVENT_CALLBACK	이벤트에 등록합니다.
WIA_UNREGISTER_EVENT_CALLBACK	이벤트에 대한 등록을 삭제합니다.
WIA_SET_DEFAULT_HANDLER	애플리케이션을 기본 이벤트 처리기로 설정합니다.

[in] bstrDeviceID

형식: BSTR

디바이스 식별자를 지정합니다. NULL을 전달하여 모든 WIA 디바이스에서 이벤트에 등록합니다.

[in] pEventGUID

형식: const GUID*

애플리케이션이 등록되는 이벤트를 지정합니다. 유효한 이벤트 GUID 목록은 WIA 이벤트 식별자를 참조하세요.

[in] bstrCommandline

형식: BSTR

전체 경로 이름과 애플리케이션을 호출하는 데 필요한 적절한 명령줄 인수를 포함하는 문자열을 지정합니다. 두 쌍의 따옴표(예: "C:\Program Files\MyExe.exe" /arg1")를 사용해야 합니다.

[in] bstrName

형식: BSTR

애플리케이션의 이름을 지정합니다. 이 이름은 여러 애플리케이션이 동일한 이벤트에 등록할 때 사용자에게 표시됩니다.

[in] bstrDescription

형식: BSTR

애플리케이션에 대한 설명을 지정합니다. 이 설명은 여러 애플리케이션이 동일한 이벤트에 등록할 때 사용자에게 표시됩니다.

[in] bstrIcon

형식: BSTR

애플리케이션을 나타내는 아이콘을 지정합니다. 아이콘은 여러 애플리케이션이 동일한 이벤트에 등록할 때 사용자에게 표시됩니다. 문자열에는 애플리케이션의 이름과 아이콘의 0 기반 인덱스(애플리케이션을 나타내는 아이콘이 둘 이상 있을 수 있음)가 쉼표로 구분되어 있습니다. 예를 들어 "MyApp, 0"입니다.

반환 값

형식: HRESULT

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

설명

IWiaDevMgr::RegisterEventCallbackProgram을 사용하여 WIA_ACTION_EVENT 형식의 하드웨어 디바이스 이벤트에 등록합니다. 애플리케이션이 등록된 이벤트가 발생하면 애플리케이션이 시작되고 이벤트 정보가 애플리케이션으로 전송됩니다.

애플리케이션은 EnumRegisterEventInfo 메서드를 사용하여 이벤트 등록 속성에 대한 열거자 개체에 대한 포인터를 검색합니다.

애플리케이션은 이벤트 열거형에서 반환된 WIA_DEV_CAP 구조체의 ulFlags 값을 검사하여 이벤트가 작업 유형인지 알림 유형인지(또는 둘 다) 이벤트인지 확인할 수 있습니다.

프로그램은 WIA 아키텍처용으로 작성되지 않은 애플리케이션과의 이전 버전과의 호환성을 위해 IWiaDevMgr::RegisterEventCallbackProgram 메서드만 사용해야 합니다. 새 애플리케이션은 WIA 아키텍처에서 제공하는 COM(구성 요소 개체 모델) 인터페이스를 사용해야 합니다. 특히 디바이스 이벤트에 등록하려면 IWiaDevMgr::RegisterEventCallbackInterface 또는 IWiaDevMgr::RegisterEventCallbackCLSID 를 호출해야 합니다.

일반적으로 이 메서드는 설치 프로그램 또는 스크립트에서 호출됩니다. 설치 프로그램 또는 스크립트는 WIA 디바이스 이벤트를 수신하도록 애플리케이션을 등록합니다. 이벤트가 발생하면 WIA 런타임 시스템에서 애플리케이션을 시작합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wia_xp.h(Wia.h 포함)
라이브러리	Wiaguid.lib
DLL	Wiaservc.dll