IStillImageW::RegisterLaunchApplication 메서드(sti.h)

IStillImage::RegisterLaunchApplication 메서드는 스틸 이미지 이벤트 모니터의 푸시 모델 인식 애플리케이션 목록에 애플리케이션을 추가합니다.

구문

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

매개 변수

[in] pwszAppName

스캐너 및 카메라 제어판 속성 시트가 표시할 애플리케이션의 "짧은 이름"을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

[in] pwszCommandLine

애플리케이션의 실행 파일에 대한 전체 경로를 포함하여 애플리케이션을 시작하는 데 필요한 명령줄을 나타내는 문자열에 대한 호출자 제공 포인터입니다. 현재 경로는 GetModuleFileName(Microsoft Windows SDK 설명서에 설명됨)을 호출하여 가져올 수 있습니다. 자세한 내용은 다음 주의 섹션을 참조 하세요 .

반환 값

작업이 성공하면 메서드는 S_OK 반환합니다. 그렇지 않으면 stierr.h에 정의된 STIERR 접두사 오류 코드 중 하나를 반환합니다.

설명

애플리케이션(또는 애플리케이션의 설치 관리자)은 IStillImage::RegisterLaunchApplication 을 호출해야 스틸 이미지 이벤트 모니터가 해당 존재를 알 수 있습니다. 사용자는 제어판 속성 시트 인터페이스를 사용하여 스틸 이미지 디바이스 이벤트를 등록된 애플리케이션과 연결합니다. 사용자가 디바이스 이벤트를 애플리케이션과 연결한 후에는 이벤트가 발생할 때 이벤트 모니터가 애플리케이션을 시작합니다.

메서드는 레지스트리에 애플리케이션의 로드 경로를 씁니다. 따라서 사용자가 파일을 이동했을 수 있고 GetModuleFileName 이 항상 현재 파일 위치를 반환하므로 애플리케이션이 실행될 때마다 메서드를 호출해야 합니다.

애플리케이션의 명령줄에 명령 인수를 포함할 수 있습니다. 등록된 애플리케이션을 시작할 때 이벤트 모니터는 명령줄에 다음 두 인수를 추가합니다.

명령줄 인수	Description
**/StiDevice:**InternalDeviceName	InternalDeviceName 은 애플리케이션이 시작되는 디바이스의 내부 디바이스 이름입니다.
**/StiEvent:**EventGUID	EventGUID 는 발생한 디바이스 이벤트에 대한 GUID의 문자열 표현입니다.

애플리케이션은 IStillImage::GetSTILaunchInformation을 호출하여 이러한 인수에 대해 지정된 값을 가져올 수 있습니다.

IStillImage::RegisterLaunchApplication을 호출하기 전에 IStillImage COM 인터페이스의 클라이언트는 IStillImage::StiCreateInstance를 호출하여 IStillImage 인터페이스 포인터를 가져와야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	sti.h(Sti.h 포함)