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)

Weitere Informationen

IHandlerActivationHost