IHandlerActivationHost::BeforeCoCreateInstance 메서드(shobjidl_core.h)
처리기가 만들어질 예정임을 ShellExecuteEx 의 클라이언트에 알리고 해당 클라이언트가 해당 처리기의 사용을 확인하는 UI를 표시하거나 특정 오류 코드를 반환하여 거부할 수 있는 기회를 제공합니다.
구문
HRESULT BeforeCoCreateInstance(
[in] REFCLSID clsidHandler,
[in] IShellItemArray *itemsBeingActivated,
[in] IHandlerInfo *handlerInfo
);
매개 변수
[in] clsidHandler
처리기를 식별합니다.
[in] itemsBeingActivated
처리기에 전달될 Shell 항목 개체입니다. 일반적으로 하나만 있지만 경우에 따라 둘 이상이 있을 수 있습니다.
[in] handlerInfo
호출될 처리기에 대한 정보에 대한 액세스를 제공합니다. 이 개체는 해당 인터페이스를 지원하는 Windows 버전에서도 IHandlerInfo2 를 지원합니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다 . HRESULT_FROM_WIN32(ERROR_CANCELLED) 는 ShellExecute 호출을 취소해야 하며 , EXECUTE_E_LAUNCH_APPLICATION 이 처리기를 사용하면 안 되지만 다른 처리기가 있는 경우 사용해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shobjidl_core.h(Shobjidl.h 포함) |