IObexSink::Notify
A version of this page is also available for
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 |