Bagikan melalui


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)

Lihat juga

IExternalConnection