IAttachmentExecute::Execute method (shobjidl_core.h)

Artikel
08/26/2023

Menjalankan tindakan pada lampiran.

Sintaks

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

Parameter

[in] hwnd

Jenis: HWND

Handel jendela induk.

[in, optional] pszVerb

Jenis: LPCWSTR

Penunjuk ke string yang dihentikan null yang berisi kata kerja yang menentukan tindakan yang akan dilakukan pada file. Lihat parameter lpOperation di ShellExecute untuk string yang valid. Nilai ini bisa NULL.

[out, optional] phProcess

Jenis: HANDLE*

Penunjuk ke handel ke proses sumber, digunakan untuk operasi sinkron. Nilai ini bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Sebelum memanggil IAttachmentExecute::Execute, IAttachmentExecute::SetLocalPath harus dipanggil dengan jalur lokal yang valid dan file harus disalin ke lokasi tersebut.

Jika perintah ditunjukkan, IAttachmentExecute::Execute memanggil IAttachmentExecute::P rompt menggunakan nilai ATTACHMENT_ACTION_EXEC .

IAttachmentExecute::Execute dapat menjalankan pemindai virus atau layanan kepercayaan lainnya untuk memvalidasi file sebelum mengeksekusinya. Perhatikan bahwa layanan ini dapat menghapus atau mengubah file.

IAttachmentExecute::Execute dapat melampirkan bukti ke jalur lokal dalam aliran data alternatif (ADS) NTFS-nya.

Jika phProcess bukan NULL, IAttachmentExecute::Execute beroperasi sebagai proses sinkron dan mengembalikan HPROCESS, jika tersedia. Jika phProcessadalah NULL, IAttachmentExecute::Execute beroperasi sebagai proses asinkron. Ini menyiratkan bahwa aplikasi panggilan memiliki pompa pesan dan jendela berumur panjang.

Jika handel yang diarahkan oleh phProcess bukan NULL ketika metode kembali, aplikasi panggilan bertanggung jawab untuk memanggil CloseHandle untuk membebaskan handel ketika tidak lagi diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shdocvw.dll (versi 6.0 atau yang lebih baru)

Bagikan melalui