Zugreifen auf Geräteklasseneigenschaften

In Windows Vista und höheren Versionen von Windows können Anwendungen und Installationsprogramme auf Geräteeinrichtungsklasseneigenschaften und Geräteschnittstellenklasseneigenschaften zugreifen, indem sie die folgenden Funktionen aufrufen.

Hinweis

SetupApi wird nicht in allen Editionen von Windows unterstützt. Wenn möglich, sollten Sie APIs auf niedrigerer Ebene verwenden, z. B . apIs, die überCfgMgr32.dllverfügbar sind. Tipps finden Sie unter Portieren von SetupApi zu CfgMgr32 .

Informationen zum Zugreifen auf Geräteklasseneigenschaften unter Windows Server 2003, Windows XP und Windows 2000 finden Sie unter Zugreifen auf Geräteeinrichtungsklasseneigenschaften und Zugreifen auf Geräteschnittstellenklasseneigenschaften.

Abrufen von Eigenschaften

Eigenschaften-APIs wie CM_Get_Class_Property oder SetupDiGetClassProperty können verwendet werden, um eine Klasseneigenschaft für eine Gerätesetupklasse oder eine Geräteschnittstellenklasse abzurufen.

Festlegen von Eigenschaften

Eigenschaften-APIs wie CM_Set_Class_Property oder SetupDiSetClassProperty können verwendet werden, um eine Klasseneigenschaft für eine Gerätesetupklasse oder Geräteschnittstellenklasse festzulegen.

Abrufen einer Liste der verfügbaren Eigenschaften

Eigenschaften-APIs wie CM_Get_Class_Property_Keys oder SetupDiGetClassPropertyKeys können verwendet werden, um ein Array der Eigenschaftenschlüssel abzurufen, die die Eigenschaften identifizieren, die derzeit für eine Gerätesetupklasse oder Geräteschnittstellenklasse festgelegt sind. Dies kann verwendet werden, um den vollständigen Satz von Eigenschaften zu bestimmen, die für eine Klasse festgelegt sind. Die Verwendung dieser Funktionen, insbesondere zum anschließenden Abrufen des Werts aller Eigenschaften, die diese Funktionen angeben, sollte jedoch sparsam verwendet werden, da das Abrufen der Liste aller Eigenschaften und ihrer Werte ein kostspieliger Vorgang sein kann.