This interface is implemented by the Windows CE connection manager. It allows an application some control of the 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.
At a Glance
| Header file: | Dccole.h |
| Windows CE versions: | 1.0 and later |
| Methods | Description |
| IDccMan::Advise | Registers an IDccManSink object so that it can receive connection notifications from the Windows CE connection manager. |
| IDccMan::ShowCommSettings | Displays the dialog box for setting the communications port. |
| IDccMan::Unadvise | Unregisters the client. |
Remarks
The IDccManSink::OnLog* methods should return a value of NOERROR.
An IDccMan interface method typically return 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.
For more information, see Receiving Connection Notification.
This method registers an IDccManSink object so that it can receive connection notifications from the Windows CE connection manager.
At a Glance
| Header file: | Dccole.h |
| Windows CE versions: | 1.0 and later |
Syntax
HRESULT STDMETHODIMP IDccMan::Advise( IDccManSink * pDccSink,
DWORD pdwContext );
Parameters
pDccSink
Pointer to an IDccManSink object that receives connection notifications.
pdwContext
Pointer to a DWORD that receives a context value used by the IDccMan object to identify the IDccManSink object that was passed in. The value pointed to by pdwContext should be passed in the call to IDccMan::Unadvise.
Return Values
NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.
Remarks
For more information, see Receiving Connection Notification.
See Also