Partager via


IObexSink::Notify

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method notifies the user of incoming requests.

Syntax

HRESULT Notify(
  OBEX_EVENT Event,
  IUnknown* pUnk1,
  IUnknown* pUnk2
);

Parameters

  • Event
    [in] Event message. The possible values of this parameter are identified in the following table.

    Value Description

    OE_DEVICE_ARRIVAL

    A new device is within range.

    OE_DEVICE_DEPARTURE

    A device that was in range is no longer within range.

    OE_DEVICE_UPDATE

    The name of a remote device has changed.

  • pUnk1
    [in] Pointer to the first parameter definition.
  • pUnk2
    [in] Pointer to the second parameter definition.

Return Value

The appropriate HResult is returned.

Remarks

This method is useful when an event requires the user's attention (Disconnect and Abort requests, for example). The user can also be prompted for a password when making a connection to an OBEX server. The parameter definitions that are passed to the function are dependent upon the message.

This method is called when a device is discovered or when more information about it is found.

When you implement this method, it must be thread safe.

Note

There is one callback thread for each IObex interface. No time consuming operations should be performed on the callback notifications. If any long operations are performed, then notification of the other OBEX events will be delayed until the notification returns.

Requirements

Header obex.h, obex.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IObexSink:IUnknown
OBEX Interfaces