Fungsi SetProcessReference (shlwapi.h)
Menyediakan objek Model Objek Komponen (COM) 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 SetProcessReference(
[in, optional] IUnknown *punk
);
Parameter
[in, optional] punk
Penunjuk ke objek yang ingin Anda simpan referensinya. Nilai ini bisa NULL.
Menampilkan nilai
Tidak ada
Keterangan
Windows Explorer dan Internet Explorer dapat menggunakan SetProcessReference untuk memungkinkan komponen seperti ekstensi Shell memperpanjang masa pakai proses. Aplikasi lain juga dapat menggunakan SetProcessReference untuk memungkinkan kemampuan yang sama. Misalnya, perulangan pesan browser dan desktop proksi menggunakan SetProcessReference untuk memungkinkan utas lain memperpanjang masa pakainya.
Aplikasi selain Windows Explorer dan Internet Explorer yang memanggil fungsi ini mungkin mengalami masalah kompatibilitas karena beberapa komponen menggunakan SetProcessReference untuk mendeteksi apakah komponen tersebut dihosting dari dalam Windows Explorer atau Internet Explorer.
Penunjuk antarmuka yang diteruskan ke SetProcessReference harus mereferensikan objek utas bebas.
Setiap kali komponen memanggil GetProcessReference, sistem memanggil metode AddRef sebelum mengembalikan penunjuk antarmuka ke komponen panggilan. Komponen kemudian memanggil metode IUnknown::Release saat pemrosesan selesai. Proses yang memanggil SetProcessReference tidak boleh dihentikan sementara jumlah referensi penunjuk antarmuka yang disediakan bukan nol.
Untuk informasi lebih lanjut tentang cara komponen menggunakan referensi proses, lihat GetProcessReference.
Persyaratan
| Klien minimum yang didukung | Windows 8 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Api-ms-win-shcore-thread-L1-1-0.dll |