IHandlerActivationHost::BeforeCoCreateInstance-Methode (shobjidl_core.h)
Benachrichtigt einen Client von ShellExecuteEx über die Erstellung eines Handlers, sodass dieser Client die Möglichkeit hat, eine Benutzeroberfläche anzuzeigen, die die Verwendung dieses Handlers bestätigt oder durch Zurückgeben eines bestimmten Fehlercodes ablehnt.
Syntax
HRESULT BeforeCoCreateInstance(
[in] REFCLSID clsidHandler,
[in] IShellItemArray *itemsBeingActivated,
[in] IHandlerInfo *handlerInfo
);
Parameter
[in] clsidHandler
Identifiziert den Handler.
[in] itemsBeingActivated
Die Shellelementobjekte, die an den Handler übergeben werden. In der Regel gibt es nur eine, aber in einigen Fällen kann es mehrere sein.
[in] handlerInfo
Bietet Zugriff auf Informationen über den Handler, der aufgerufen wird. Dieses Objekt unterstützt auch IHandlerInfo2 unter Windows-Versionen, die diese Schnittstelle unterstützen.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, HRESULT_FROM_WIN32(ERROR_CANCELLED) angibt, dass der ShellExecute-Aufruf abgebrochen werden soll, EXECUTE_E_LAUNCH_APPLICATION gibt an, dass dieser Handler nicht verwendet werden soll, aber wenn es einen anderen gibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (einschließlich Shobjidl.h) |