DEVPROP_TYPE_EMPTY

No Windows Vista e versões posteriores do Windows, o identificador DEVPROP_TYPE_EMPTY representa um identificador especial de tipo de dados base que indica que uma propriedade não existe.

Comentários

Use esse identificador de tipo de dados base com as funções de propriedade do dispositivo para excluir uma propriedade.

Se uma função de propriedade do dispositivo retornar esse identificador de tipo de dados base, a propriedade não existirá.

DEVPROP_TYPE_EMPTY não pode ser combinado com os modificadores de tipo de dados de propriedade DEVPROP_TYPEMOD_ARRAY ou DEVPROP_TYPEMOD_LIST.

Excluindo uma propriedade

Para excluir uma propriedade, chame a função de propriedade SetupDiSetXxx correspondente e defina os parâmetros de função da seguinte maneira:

• Defina o parâmetro PropertyType como DEVPROP_TYPE_EMPTY, o parâmetro PropertyBuffer como NULL e o parâmetro PropertyBufferSize como zero.

• Defina os outros parâmetros de entrada de função conforme apropriado para definir a propriedade .

Se DEVPROP_TYPE_EMPTY for usado na tentativa de excluir uma propriedade que não existe, a operação de exclusão falhará e uma chamada para GetLastError retornará ERROR_NOT_FOUND.

Recuperando uma propriedade que não existe

Uma chamada para uma função de propriedade SetupDiGetXxx que tenta recuperar uma propriedade de dispositivo que não existe falhará e uma chamada subsequente para GetLastError retornará ERROR_NOT_FOUND. A função de propriedade SetupAPI chamada definirá o parâmetro *PropertyType como DEVPROP_TYPE_EMPTY.

Requisitos