CoIsHandlerConnected (Windows Embedded CE 6.0)
1/6/2010
This function determines whether a remote object is connected to the corresponding in-process object.
Syntax
BOOL CoIsHandlerConnected(
LPUNKNOWN pUnk
);
Parameters
- pUnk
[in] Pointer to the controlling IUnknown interface on the remote object.
Return Value
- 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
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |