IDccMan (Compact 7)

3/12/2014

This interface is implemented by Connection Manager. It allows an application some control of Connection Manager and the ability to register for connection notifications.

An application creates this interface by calling the COM CoCreateInstance function, using the CLSID_DccMan globally unique identifier (GUID), and receiving a pointer to an IDccMan interface.

Methods

The following table shows the methods for this interface in alphabetical order.

Method Description

Advise

Registers an IDccManSink object so that it can receive connection notifications from Connection Manager.

ShowCommSettings

Displays the dialog box for setting the communications port.

Unadvise

Unregisters the client.

Remarks

The IDccManSink::OnLog* methods should return a value of NOERROR.

An IDccMan interface method typically returns a value of NOERROR if the method succeeds.

If a method fails, it uses the HRESULT_FROM_WIN32 macro to return an HRESULT Win32 error value.

The application can display the error by using the Win32 FormatMessage function to create the error string.

For more information about message tables, see the Win32 Programmer's Reference.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header

dccole.h

Library

ole32.lib,
uuid.lib

See Also

Reference

COM Interfaces
CoCreateInstance
IDccMan::Advise
IDccMan::ShowCommSettings
IDccMan::Unadvise