Zugreifen auf benutzerdefinierte Einstellungen

Unter Windows Vista und höheren Versionen von Windows unterstützt das einheitliche Geräteeigenschaftenmodell die Verwendung von Eigenschaftenschlüsseln zum Erstellen und Zugreifen auf benutzerdefinierte Geräteeigenschaften. Weitere Informationen finden Sie unter Erstellen benutzerdefinierter Geräteeigenschaften.

Unter Windows Server 2003, Windows XP und Windows 2000 können Sie benutzerdefinierte Registrierungseintragswerte unter den vom System bereitgestellten Registrierungsschlüsseln für eine gerätebezogene Komponente erstellen. Die folgende Liste enthält die SetupAPI-Funktion, die für jeden Gerätekomponententyp aufgerufen werden soll, um den entsprechenden vom System bereitgestellten Registrierungsschlüssel zu öffnen. Nachdem Sie den systemdefinierte Registrierungsschlüssel geöffnet haben, können Anwendungen und Installationsprogramme die Windows-basierten Registrierungsfunktionen aufrufen, um benutzerdefinierte Registrierungseintragswerte unter dem geöffneten Registrierungsschlüssel zu ändern.

  • Ein benutzerdefinierter Registrierungseintragswert für ein Gerät instance Hardwareeigenschaft sollte sich unter dem Hardwareregistrierungsschlüssel eines Geräts instance befinden. Rufen Sie SetupDiOpenDevRegKey auf, und geben Sie DIREG_DEV im Flags-Parameter an, um ein Handle für den Hardwareschlüssel eines Geräts instance abzurufen. Benutzerdefinierte Registrierungseintragswerte, die unter dem Hardwareregistrierungsschlüssel für ein Gerät instance festgelegt sind, können durch Aufrufen der SetupDiGetCustomDeviceProperty-Funktion abgerufen werden.

  • Ein benutzerdefinierter Registrierungseintragswert für ein Gerät instance Softwareeigenschaft sollte sich unter dem Softwareregistrierungsschlüssel eines Geräts instance befinden. Rufen Sie SetupDiOpenDevRegKey auf, und geben Sie DIREG_DRV im Flags-Parameter an, um ein Handle für den Softwareschlüssel eines Geräts instance abzurufen.

  • Ein benutzerdefinierter Registrierungseintragswert für eine Geräteeinrichtungsklasseneigenschaft sollte sich unter dem Registrierungsschlüssel der Geräteeinrichtungsklasse befinden. Rufen Sie SetupDiOpenClassRegKeyEx auf, und geben Sie DIOCR_INSTALLER im Flags-Parameter an, um ein Handle für den Registrierungsschlüssel für eine Gerätesetupklasse abzurufen.

  • Ein benutzerdefinierter Registrierungseintragswert für eine Geräteschnittstellenklasseneigenschaft sollte sich unter dem Registrierungsschlüssel der Geräteschnittstellenklasse befinden. Rufen Sie SetupDiOpenClassRegKeyEx auf, und geben Sie DIOCR_INTERFACE im Flags-Parameter an, um ein Handle für den Registrierungsschlüssel für eine Geräteschnittstellenklasse abzurufen.

  • Ein benutzerdefinierter Registrierungseintragswert für eine Geräteschnittstelleneigenschaft sollte sich unter dem Registrierungsschlüssel der Geräteschnittstelle befinden. Rufen Sie SetupDiOpenDeviceInterfaceRegKey auf, um ein Handle für den Registrierungsschlüssel für eine Geräteschnittstellenklasse abzurufen.

Nachdem Sie ein Handle für einen Registrierungsschlüssel abgerufen haben, geben Sie das Handle in einem Aufruf von RegQueryValueEx oder RegSetValueEx an, um den benutzerdefinierten Registrierungseintragswert abzurufen oder festzulegen, der der benutzerdefinierten Geräteeigenschaft entspricht.

Rufen Sie die RegCloseKey-Funktion auf, um den Registrierungsschlüssel zu schließen, nachdem kein Zugriff mehr auf den Registrierungsschlüssel erforderlich ist.