Share via


DEVPROP_TYPE_EMPTY

In Windows Vista und höheren Versionen von Windows stellt der DEVPROP_TYPE_EMPTY-Bezeichner einen speziellen Basisdatentypbezeichner dar, der angibt, dass eine Eigenschaft nicht vorhanden ist.

Bemerkungen

Verwenden Sie diesen Basisdatentypbezeichner mit den Geräteeigenschaftenfunktionen, um eine Eigenschaft zu löschen.

Wenn eine Geräteeigenschaftsfunktion diesen Basisdatentypbezeichner zurückgibt, ist die Eigenschaft nicht vorhanden.

DEVPROP_TYPE_EMPTY können nicht mit den Eigenschaftsdatentypmodifizierern DEVPROP_TYPEMOD_ARRAY oder DEVPROP_TYPEMOD_LIST kombiniert werden.

Löschen einer Eigenschaft

Um eine Eigenschaft zu löschen, rufen Sie die entsprechende SetupDiSetXxx-Eigenschaftsfunktion auf, und legen Sie die Funktionsparameter wie folgt fest:

  • Legen Sie den PropertyType-Parameter auf DEVPROP_TYPE_EMPTY, den PropertyBuffer-Parameter auf NULL und den PropertyBufferSize-Parameter auf Null fest.

  • Legen Sie die anderen Funktionseingabeparameter entsprechend fest, um die -Eigenschaft festzulegen.

Wenn DEVPROP_TYPE_EMPTY verwendet wird, um eine Eigenschaft zu löschen, die nicht vorhanden ist, schlägt der Löschvorgang fehl, und ein Aufruf von GetLastError gibt ERROR_NOT_FOUND zurück.

Abrufen einer Eigenschaft, die nicht vorhanden ist

Ein Aufruf einer SetupDiGetXxx-Eigenschaftsfunktion , die versucht, eine Geräteeigenschaft abzurufen, die nicht vorhanden ist, schlägt fehl, und ein späterer Aufruf von GetLastError gibt ERROR_NOT_FOUND zurück. Die aufgerufene SetupAPI-Eigenschaftsfunktion legt den *PropertyType-Parameter auf DEVPROP_TYPE_EMPTY fest.

Anforderungen

Header

Devpropdef.h (einschließlich Devpropdef.h)