DEVPROP_TYPE_EMPTY

En Windows Vista y versiones posteriores de Windows, el identificador DEVPROP_TYPE_EMPTY representa un identificador especial de tipo de datos base que indica que una propiedad no existe.

Observaciones

Use este identificador de tipo de datos base con las funciones de propiedad del dispositivo para eliminar una propiedad.

Si una función de propiedad de dispositivo devuelve este identificador de tipo de datos base, la propiedad no existe.

DEVPROP_TYPE_EMPTY no se puede combinar con los modificadores property-data-type DEVPROP_TYPEMOD_ARRAY o DEVPROP_TYPEMOD_LIST.

Eliminar una propiedad

Para eliminar una propiedad, llame a la función de propiedadSetupDiSet Xxx correspondiente y establezca los parámetros de función de la siguiente manera:

• Establezca el parámetro PropertyType en DEVPROP_TYPE_EMPTY, el parámetro PropertyBuffer en NULL y el parámetro PropertyBufferSize en cero.

• Establezca los demás parámetros de entrada de función según corresponda para establecer la propiedad .

Si DEVPROP_TYPE_EMPTY se usa en un intento de eliminar una propiedad que no existe, se producirá un error en la operación de eliminación y se devolverá una llamada a GetLastError ERROR_NOT_FOUND.

Recuperar una propiedad que no existe

Se producirá un error en una llamada a una función de propiedad SetupDiGetXxx que intente recuperar una propiedad de dispositivo que no exista y una llamada posterior a GetLastError devolverá ERROR_NOT_FOUND. La función de propiedad SetupAPI denominada establecerá el parámetro *PropertyType en DEVPROP_TYPE_EMPTY.

Requisitos

Encabezado

Devpropdef.h (incluya Devpropdef.h)