Share via


CoIsHandlerConnected (Compact 2013)

3/26/2014

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

Header

objbase.h

Library

ole32.lib

See Also

Reference

COM Functions