IHandlerActivationHost::BeforeCreateProcess-Methode (shobjidl_core.h)
Benachrichtigt einen Client von ShellExecuteEx , dass ein Prozess gerade erstellt werden soll, und gibt diesem Client die Möglichkeit, die Benutzeroberfläche anzuzeigen, die dies bestätigt, oder lehnt ihn ab, indem ein bestimmter Fehlercode zurückgegeben wird.
Syntax
HRESULT BeforeCreateProcess(
[in] LPCWSTR applicationPath,
[in] LPCWSTR commandLine,
[in] IHandlerInfo *handlerInfo
);
Parameter
[in] applicationPath
Der vollqualifizierte Pfad zur ausführbaren Prozessdatei oder in einigen Fällen ein DLL-Pfad.
[in] commandLine
Die vollständige Befehlszeile, die an CreateProcess übergeben wird, einschließlich der Argumente, die der Handler über seine Registrierung angefordert hat.
[in] handlerInfo
Bietet Zugriff auf Informationen über den Handler, der aufgerufen wird. Dieses Objekt unterstützt auch IHandlerInfo2 für Windows-Versionen, die diese Schnittstelle unterstützen. Dieses Objekt implementiert auch IObjectWithSelection. Dies kann verwendet werden, um das Shellelement oder in einigen Fällen Elemente abzurufen, die gestartet werden.
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.
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) |