SetupDiCancelDriverInfoSearch function (setupapi.h)

The SetupDiCancelDriverInfoSearch function cancels a driver list search that is currently in progress in a different thread.

Syntax

WINSETUPAPI BOOL SetupDiCancelDriverInfoSearch(
  [in] HDEVINFO DeviceInfoSet
);

Parameters

[in] DeviceInfoSet

A handle to the device information set for which a driver list is being built.

Return value

If a driver list search is underway for the specified device information set when this function is called, the search is terminated. SetupDiCancelDriverInfoSearch returns TRUE when the termination is confirmed. Otherwise, it returns FALSE and a call to GetLastError returns ERROR_INVALID_HANDLE.

Remarks

SetupDiCancelDriverInfoSearch is a synchronous call. Therefore, it does not return until the driver search thread responds to the termination request.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows 2000 and later versions of Windows.
Target Platform Desktop
Header setupapi.h (include Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

See also

SetupDiBuildDriverInfoList