Platform SDK: COM

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.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in objbase.h.
  Library: Use ole32.lib.