DEVPROP_TYPE_EMPTY

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

Remarks

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 pueden 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 propiedad SetupDiSetXxx correspondiente y establezca los parámetros de función como se indica a continuación:

• 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 intenta recuperar una propiedad de dispositivo que no existe y se devolverá una llamada posterior a GetLastError ERROR_NOT_FOUND. La función de propiedad SetupAPI denominada establecerá el parámetro *PropertyType en DEVPROP_TYPE_EMPTY.

Requirements

Encabezado

Devpropdef.h (incluya Devpropdef.h)