Metode IHandlerActivationHost::BeforeCoCreateInstance (shobjidl_core.h)

Memberi tahu klien ShellExecuteEx bahwa handler akan dibuat, memberi klien kesempatan untuk menampilkan UI yang mengonfirmasi penggunaan handler tersebut atau menolaknya dengan mengembalikan kode kesalahan tertentu.

Sintaks

HRESULT BeforeCoCreateInstance(
  [in] REFCLSID        clsidHandler,
  [in] IShellItemArray *itemsBeingActivated,
  [in] IHandlerInfo    *handlerInfo
);

Parameter

[in] clsidHandler

Mengidentifikasi handler.

[in] itemsBeingActivated

Objek item Shell yang akan diteruskan ke handler. Biasanya hanya ada satu, tetapi dalam beberapa kasus mungkin ada lebih dari satu.

[in] handlerInfo

Menyediakan akses ke informasi tentang handler yang akan dipanggil. Objek ini juga mendukung IHandlerInfo2 pada versi Windows yang mendukung antarmuka tersebut.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, ia mengembalikan kode kesalahan HRESULT , HRESULT_FROM_WIN32(ERROR_CANCELLED) menunjukkan bahwa panggilan ShellExecute harus dibatalkan, EXECUTE_E_LAUNCH_APPLICATION menunjukkan bahwa handler ini tidak boleh digunakan, tetapi jika ada yang lain, itu harus digunakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

IHandlerActivationHost