DEVPROP_TYPE_EMPTY

在 Windows Vista 和更高版本的 Windows 中,DEVPROP_TYPE_EMPTY标识符表示一个特殊的基数据类型标识符,该标识符指示属性不存在。

注解

将此 base-data-type 标识符与设备属性函数一起使用可删除属性。

如果设备属性函数返回此 base-data-type 标识符,则 属性不存在。

DEVPROP_TYPE_EMPTY 不能与属性数据类型修饰符 DEVPROP_TYPEMOD_ARRAYDEVPROP_TYPEMOD_LIST结合使用。

删除属性

若要删除属性,请调用相应的 SetupDiSetXxx 属性函数并设置函数参数,如下所示:

  • PropertyType 参数设置为 DEVPROP_TYPE_EMPTY, 将 PropertyBuffer 参数设置为 NULLPropertyBufferSize 参数设置为零。

  • 根据需要设置其他函数输入参数以设置 属性。

如果使用 DEVPROP_TYPE_EMPTY 尝试删除不存在的属性,则删除操作将失败,对 GetLastError 的调用将返回ERROR_NOT_FOUND。

检索不存在的属性

尝试检索不存在的设备属性的 SetupDiGetXxx 属性函数的调用将失败,对 GetLastError 的后续调用将返回ERROR_NOT_FOUND。 调用的 SetupAPI 属性函数会将 *PropertyType 参数设置为 DEVPROP_TYPE_EMPTY。

要求

标头

Devpropdef.h (包括 Devpropdef.h)