IAttachmentExecute::Execute-Methode (shobjidl_core.h)

Artikel
08/26/2023

Führt eine Aktion für eine Anlage aus.

Syntax

HRESULT Execute(
  [in]            HWND    hwnd,
  [in, optional]  LPCWSTR pszVerb,
  [out, optional] HANDLE  *phProcess
);

Parameter

[in] hwnd

Typ: HWND

Das Handle des übergeordneten Fensters.

[in, optional] pszVerb

Typ: LPCWSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die ein Verb enthält, das die aktion angibt, die für die Datei ausgeführt werden soll. Gültige Zeichenfolgen finden Sie im Parameter lpOperation in ShellExecute . Dieser Wert kann NULL sein.

[out, optional] phProcess

Typ: HANDLE*

Ein Zeiger auf ein Handle auf den Quellprozess, der für den synchronen Vorgang verwendet wird. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Vor dem Aufrufen von IAttachmentExecute::Execute muss IAttachmentExecute::SetLocalPath mit einem gültigen lokalen Pfad aufgerufen werden, und die Datei muss an diesen Speicherort kopiert werden.

Wenn eine Eingabeaufforderung angezeigt wird, ruft IAttachmentExecute::ExecuteIAttachmentExecute::P rompt mithilfe des ATTACHMENT_ACTION_EXEC-Werts auf.

IAttachmentExecute::Execute kann Virenscanner oder andere Vertrauensdienste ausführen, um die Datei vor der Ausführung zu überprüfen. Beachten Sie, dass diese Dienste die Datei löschen oder ändern können.

IAttachmentExecute::Execute kann Beweise an den lokalen Pfad im NTFS-Alternativen Datenstrom (ADS) anfügen.

Wenn phProcess nicht NULL ist, wird IAttachmentExecute::Execute als synchroner Prozess ausgeführt und gibt einen HPROCESS zurück, falls verfügbar. Wenn phProcessNULL ist, wird IAttachmentExecute::Execute als asynchroner Prozess ausgeführt. Dies bedeutet, dass die aufrufende Anwendung über eine Nachrichtenpumpe und ein langlebiges Fenster verfügt.

Wenn das Handle, auf das von phProcess verwiesen wird, nicht NULL ist, wenn die Methode zurückgibt, ist die aufrufende Anwendung für den Aufruf von CloseHandle verantwortlich, um das Handle frei zu geben, wenn es nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shdocvw.dll (Version 6.0 oder höher)

Share via