Fungsi CoIsHandlerConnected (combaseapi.h)

Menentukan apakah objek jarak jauh tersambung ke objek dalam proses yang sesuai.

Sintaks

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Parameter

[in] pUnk

Penunjuk ke antarmuka IUnknown yang mengontrol pada objek jarak jauh.

Nilai kembali

Jika objek tidak jarak jauh atau jika jarak jauh dan masih tersambung, nilai yang dikembalikan adalah TRUE; jika tidak, itu adalah FALSE.

Keterangan

Fungsi CoIsHandlerConnected menentukan status objek jarak jauh. Anda dapat menggunakannya untuk menentukan kapan harus merilis objek jarak jauh. Anda menentukan objek jarak jauh dengan memberikan fungsi penunjuk ke antarmuka IUnknown yang mengontrolnya (parameter pUnk ). Nilai TRUE yang dikembalikan dari fungsi menunjukkan bahwa objek yang ditentukan tidak jarak jauh, atau itu jarak jauh dan masih terhubung ke handler jarak jauhnya. Nilai FALSE yang dikembalikan dari fungsi menunjukkan bahwa objek bersifat jarak jauh tetapi tidak lagi terhubung ke handler jarak jauhnya; dalam hal ini, penelepon harus merespons dengan merilis objek .

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	combaseapi.h (termasuk Objbase.h)
Pustaka	Ole32.lib
DLL	Ole32.dll