CoIsHandlerConnected (Windows CE 5.0)

Send Feedback

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

COM Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.