Share via


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