IHandlerActivationHost::BeforeCreateProcess-Methode (shobjidl_core.h)

  • Artikel

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)

Weitere Informationen

IHandlerActivationHost