Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
Windows Mobile Supported Windows Embedded CE Supported
4/14/2010

This enumeration represents the ways to look for a matching device and is passed as a parameter to FindFirstDeviceand FindNextDevice.

Syntax 

typedef enum {
  DeviceSearchByLegacyName, 
  DeviceSearchByDeviceName, 
  DeviceSearchByBusName, 
  DeviceSearchByGuid, 
  DeviceSearchByParent 
} DeviceSearchType;

Elements

DeviceSearchByLegacyName

Search by a legacy device name. For example, in a call to FindFirstDevice, pvSearchParammight be L"COM*" to search for all COMx: devices.

DeviceSearchByDeviceName

Search by device name. For example, in a call to FindFirstDevice, pvSearchParammight be L"$device\\COM*" to search for all COMx devices.

DeviceSearchByBusName

Search by bus name. For example, in a call to FindFirstDevice, pvSearchParam might be L"PCI_0_3*" to search for PCI_0_3_0, PCI_0_3_1 and so on.

DeviceSearchByGuid

Search by GUID. For example, in a call to FindFirstDevice, pvSearchParammust be a GUID pointer.

DeviceSearchByParent

Search by parent. For example, in a call to FindFirstDevice, pvSearchParamis an activation handle value returned from ActivateDeviceEx.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also