CoIsHandlerConnected
Determines
whether a remote object is connected to the corresponding in-process object.
BOOL CoIsHandlerConnected(
|
LPUNKNOWN pUnk |
//Pointer to the remote object |
|
); |
|
Parameter
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. You can use it to determine
when to release a remote object. You specify 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.