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