IExternalConnection::Metode ReleaseConnection (objidl.h)
Mengurangi jumlah koneksi eksternal objek yang kuat.
Sintaks
DWORD ReleaseConnection(
[in] DWORD extconn,
[in] DWORD reserved,
[in] BOOL fLastReleaseCloses
);
Parameter
[in] extconn
Jenis koneksi eksternal ke objek. Satu-satunya jenis koneksi eksternal yang saat ini didukung oleh antarmuka ini adalah kuat, yang berarti bahwa objek harus tetap hidup selama koneksi eksternal ini ada. Koneksi eksternal yang kuat diwakili oleh nilai EXTCONN_STRONG, yang didefinisikan dalam enumerasi EXTCONN.
[in] reserved
Informasi tentang koneksi. Parameter ini dicadangkan untuk digunakan oleh OLE. Nilainya bisa nol, tetapi belum tentu. Oleh karena itu, implementasi ReleaseConnection tidak boleh berisi blok kode yang eksekusinya tergantung pada apakah nilai nol dikembalikan.
[in] fLastReleaseCloses
Parameter ini TRUE jika koneksi yang dirilis adalah kunci eksternal terakhir pada objek, dan oleh karena itu objek harus ditutup. Jika tidak, objek harus tetap terbuka sampai ditutup oleh pengguna atau proses lain.
Nilai kembali
Metode mengembalikan jumlah koneksi. Nilai ini dimaksudkan untuk digunakan hanya untuk tujuan penelusuran kesalahan.
Keterangan
Jika fLastReleaseCloses sama dengan TRUE, memanggil ReleaseConnection menyebabkan objek dimatikan sendiri. Memanggil metode ini adalah satu-satunya cara di mana objek DLL, berjalan di ruang proses yang sama dengan aplikasi kontainer, akan tahu kapan harus menutup mengikuti pembaruan senyap.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | objidl.h (termasuk ObjIdl.h) |