CoIsHandlerConnected (Windows CE 5.0)
This function determines whether a remote object is connected to the corresponding in-process object.
BOOL CoIsHandlerConnected(LPUNKNOWN pUnk);
Parameters
- pUnk
[in] Pointer to the controlling IUnknown interface on the remote object.
Return Values
- TRUE
The object is not remote or that it is remote and is still connected to its remote handler. - FALSE
The object is remote and is invalid (no longer connected to its remote handler).
Remarks
The CoIsHandlerConnected function determines the status of a remote object. Your application can use it to determine when to release a remote object. The application specifies the remote object by giving the function a pointer to its controlling IUnknown interface (the pUnk parameter).
A TRUE returned from the function indicates either that the specified object is not remote, or that it is remote and is still connected to its remote handler.
A FALSE returned from the function indicates that the object is remote but is no longer connected to its remote handler; in this case, the caller should respond by releasing the object.
To determine whether the platform supports this function, see Determining Supported COM APIs.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Objbase.h.
Link Library: Ole32.lib.
See Also
Send Feedback on this topic to the authors