Fungsi SHSetInstanceExplorer (shlobj_core.h)
Menyediakan antarmuka yang memungkinkan ekstensi Shell yang dihosting dan komponen lain untuk mencegah proses host mereka ditutup sebelum waktunya. Proses host biasanya Windows Explorer atau Windows Internet Explorer, tetapi fungsi ini juga dapat digunakan oleh aplikasi lain.
Sintaks
void SHSetInstanceExplorer(
[in, optional] IUnknown *punk
);
Parameter
[in, optional] punk
Jenis: IUnknown*
Penunjuk ke IUnknown berulir bebas. Komponen dapat menggunakan antarmuka ini (melalui SHGetInstanceExplorer) untuk mencegah proses host dihentikan. Nilai ini bisa NULL, dalam hal ini referensi proses tidak lagi tersedia untuk komponen.
Mengembalikan nilai
Tidak ada
Keterangan
Windows Explorer dan Internet Explorer dapat menggunakan SHSetInstanceExplorer untuk mengizinkan komponen seperti ekstensi Shell untuk memperpanjang masa pakai proses. Aplikasi lain juga dapat menggunakan SHSetInstanceExplorer untuk memungkinkan kemampuan yang sama. Misalnya, perulangan pesan browser dan desktop proksi menggunakan SHSetInstanceExplorer untuk membiarkan utas lain memperpanjang masa pakainya.
Aplikasi selain Windows Explorer dan Internet Explorer yang memanggil fungsi ini mungkin mengalami masalah kompatibilitas karena beberapa komponen menggunakan SHGetInstanceExplorer untuk mendeteksi apakah komponen tersebut dihosting dari dalam Windows Explorer atau Internet Explorer.
Penunjuk antarmuka yang diteruskan ke SHSetInstanceExplorer harus mereferensikan objek utas bebas.
Setiap kali komponen memanggil SHGetInstanceExplorer, sistem memanggil metode AddRef sebelum mengembalikan penunjuk antarmuka ke komponen panggilan. Komponen kemudian memanggil metode IUnknown::Release saat pemrosesan selesai. Proses yang memanggil SHSetInstanceExplorer tidak boleh dihentikan sementara jumlah referensi penunjuk antarmuka yang disediakan bukan nol.
Untuk informasi lebih lanjut tentang cara komponen menggunakan referensi proses, lihat SHGetInstanceExplorer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlobj_core.h (termasuk Shlobj.h) |
| Pustaka | Shell32.lib |
| DLL | Shell32.dll (versi 5.0 atau yang lebih baru) |
| Set API | ext-ms-win-shell-shell32-l1-2-1 (diperkenalkan dalam Windows 10, versi 10.0.10240) |