coIsHandlerConnected 函式 (combaseapi.h)
判斷遠端物件是否連接到對應的進程內物件。
語法
BOOL CoIsHandlerConnected(
[in] LPUNKNOWN pUnk
);
參數
[in] pUnk
遠端物件上控制 IUnknown 介面的指標。
傳回值
如果物件不是遠端,或者它是遠端且仍然連線,則傳回值為 TRUE;否則為 FALSE。
備註
CoIsHandlerConnected 函式會決定遠端物件的狀態。 您可以使用它來判斷何時釋放遠程物件。 您可以指定遠端物件,方法是將函式的指標提供給其控制 IUnknown 介面的指標, (pUnk 參數) 。 從函式傳回的 TRUE 值表示指定的物件不是遠端,或是它是遠端,而且仍然連接到其遠端處理程式。 從函式傳回的 FALSE 值表示對象為遠端,但不再連線到其遠端處理程式;在此情況下,呼叫端應該藉由釋放 對象來回應。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | combaseapi.h (包含 Objbase.h) |
程式庫 | Ole32.lib |
Dll | Ole32.dll |