IObexSink::Notify

This method notifies the user of incoming requests.

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

Parameters

• Event
  [in] The type of event that occurred. 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] Uses IUnknown::QueryInterface to determine whether the remote device has a property bag. If the remote device has a property bag, the local device will use the properties contained within that property bag to establish a connection.

• pUnk2
  [in] This parameter is reserved for future use; the value of this parameter must be set to NULL.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

• S_OK
  The method completed successfully.

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.

Requirements

Pocket PC Platforms: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: obex.h
Library: obexguid.lib

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.