DEVPROP_TYPE_EMPTY

Dans Windows Vista et les versions ultérieures de Windows, l’identificateur DEVPROP_TYPE_EMPTY représente un identificateur spécial de type de données de base qui indique qu’une propriété n’existe pas.

Notes

Utilisez cet identificateur de type de données de base avec les fonctions de propriété de l’appareil pour supprimer une propriété.

Si une fonction de propriété d’appareil retourne cet identificateur de type de données de base, la propriété n’existe pas.

DEVPROP_TYPE_EMPTY ne peut pas être combiné avec les modificateurs de type de données de propriété DEVPROP_TYPEMOD_ARRAY ou DEVPROP_TYPEMOD_LIST.

Suppression d’une propriété

Pour supprimer une propriété, appelez la fonction de propriété SetupDiSetXxx correspondante et définissez les paramètres de la fonction comme suit :

• Définissez le paramètre PropertyType sur DEVPROP_TYPE_EMPTY, le paramètre PropertyBuffer sur NULL et le paramètre PropertyBufferSize sur zéro.

• Définissez les autres paramètres d’entrée de fonction comme il convient pour définir la propriété.

Si DEVPROP_TYPE_EMPTY est utilisé dans une tentative de suppression d’une propriété qui n’existe pas, l’opération de suppression échoue et un appel à GetLastError retourne ERROR_NOT_FOUND.

Récupération d’une propriété qui n’existe pas

Un appel à une fonction de propriété SetupDiGetXxx qui tente de récupérer une propriété d’appareil qui n’existe pas échoue et un appel ultérieur à GetLastError retourne ERROR_NOT_FOUND. La fonction de propriété SetupAPI appelée définit le paramètre *PropertyType sur DEVPROP_TYPE_EMPTY.

Spécifications

En-tête

Devpropdef.h (inclure Devpropdef.h)