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 포함)

추가 정보

IHandlerActivationHost