Share via

CoIsHandlerConnected

  • Article

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. 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.

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.

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.