DeviceControllerFinderHandler function

Represents the function that will handle the DeviceArrival and DeviceDeparture events which notify the client of changes in the list of cached devices.

Syntax

HRESULT DeviceControllerFinderHandler(
  _In_ IDeviceController *sender,
  _In_ HSTRING           uniqueDeviceName,
  _In_ IBasicDevice      *device
);

Parameters

• sender [in]
  A reference to the event source.

• uniqueDeviceName [in]
  The Unique Device Name (UDN) of the device being added or removed

• device [in]
  An IBasicDevice representation of the device being added or removed.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The function succeeded.

 

Remarks

To register this handler with the DeviceArrival event call the add_DeviceArrival method, and to unregister it call the remove_DeviceArrival event. To register this handler with the DeviceDeparture event call the add_DeviceDeparture method, and to unregister it call the remove_DeviceDeparture event.

Requirements

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Mfidl.h
Library	Mf.lib
DLL	Mf.dll