IObexSink::Notify (Compact 2013)

3/26/2014

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 Object Exchange (OBEX) Protocol 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

See Also

Reference

IObexSink
OBEX Interfaces