CoIsHandlerConnected

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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

See Also

Reference

COM Functions