Share via


IRAPIDesktop::Advise

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method registers an IRAPISink object so that it can receive notifications from the Connection Manager when mobile devices connect to and disconnect from the desktop.

Syntax

HRESULT Advise(
  IRAPISink* pISink,
  DWORD* pdwContext
);

Parameters

  • pISink
    [in] Pointer to an IRAPISink object that receives connection notifications.
  • pdwContext
    [out] Pointer to a DWORD that receives a context value that identifies the IRAPISink object that was passed in. This value can be passed to the IRAPIDesktop::UnAdvise method to stop the delivery of connection notifications to the associated IRAPISink object.

Return Value

If the operation was successful, the return value is NOERROR.

Remarks

The IRAPIDesktop::Advise method returns immediately. When a connection is made, the IRAPISink::OnDeviceConnected method of the implementation is called. To unregister an IRAPISink implementation, use IRAPIDesktop::UnAdvise.

Requirements

Header rapi2.h
Library ole32.lib, rapiuuid.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IRAPIDesktop
IRAPIDesktop::UnAdvise
IRAPISink