Platform SDK: Hardware

DBT_QUERYCHANGECONFIG

The system broadcasts the DBT_QUERYCHANGECONFIG device event to request permission to change the current configuration (dock or undock). Any application can deny this request and cancel the change.

To broadcast this device event, the system uses the WM_DEVICECHANGE message with wParam set to DBT_QUERYCHANGECONFIG and lParam set to zero.

Parameters

wParam
Set to DBT_QUERYCHANGECONFIG.
lParam
Set to zero.

Return Values

Return TRUE to grant permission to change the configuration.

Return BROADCAST_QUERY_DENY to deny permission to change the configuration.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Dbt.h.

See Also

Device Management Overview, Device Management Events, DBT_CONFIGCHANGECANCELED, DBT_CONFIGCHANGED, WM_DEVICECHANGE