IHWEventHandler2::HandleEventWithHWND 메서드(shobjidl.h)

애플리케이션이 처리하도록 등록되지 않은 콘텐츠 형식이 포함된 자동 실행 디바이스 이벤트를 처리합니다. 이 메서드는 프로세스에 상승된 권한이 필요한 경우 UI를 표시할 수 있도록 소유자 창에 대한 핸들을 제공합니다.

구문

HRESULT HandleEventWithHWND(
  [in] LPCWSTR pszDeviceID,
  [in] LPCWSTR pszAltDeviceID,
  [in] LPCWSTR pszEventType,
  [in] HWND    hwndOwner
);

매개 변수

[in] pszDeviceID

형식: LPCWSTR

디바이스 ID를 포함하는 문자열 버퍼에 대한 포인터입니다.

[in] pszAltDeviceID

형식: LPCWSTR

대체 디바이스 ID를 포함하는 문자열 버퍼에 대한 포인터입니다. 대체 디바이스 ID는 기본 디바이스 ID보다 사람이 읽을 수 있습니다.

[in] pszEventType

형식: LPCWSTR

이벤트 형식을 포함하는 문자열 버퍼에 대한 포인터입니다. 이벤트 유형에는 DeviceArrival, DeviceRemoval, MediaArrival 및 MediaRemoval이 포함되었습니다.

[in] hwndOwner

형식: HWND

표시된 자동 실행 대화 상자에 대한 핸들입니다.

반환 값

형식: HRESULT

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

설명

처리기가 호출되고 새 프로세스에서 즉각적인 권한 상승이 필요한 경우 동의 UI를 표시하려면 활성 부모 창 핸들이 필요합니다. IHWEventHandler::HandleEvent 는 핸들을 제공할 수 없으므로 깜박이는 작업 표시줄만 나타납니다. IHWEventHandler2::HandleEventWithHWND 는 HWND를 제공하고 UI를 표시할 수 있도록 합니다.

직접 사용자 작업 대신 처리기가 기본적으로 시작된 경우 HWND가 활성화되지 않고 대화 상자가 포그라운드에 표시되지 않습니다.

이벤트 유형은 C/C++ 언어 상수가 아닙니다. 리터럴 텍스트 문자열입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl.h