Festlegen der Eigenschaften der Geräteobjektregistrierung nach der Installation

Ein Benutzermodusprogramm kann die Geräteinstallationsfunktionen verwenden, um die Registrierungseinstellungen für die Eigenschaften des Geräteobjekts eines Treibers abzurufen oder festzulegen. Normalerweise werden diese Funktionen von installationssoftware verwendet, aber sie können von jedem Benutzermodus-Programm verwendet werden. (Das Programm muss von einem Benutzer ausgeführt werden, der über Administratorzugriff verfügt.)

Die Funktionen SetupDiGetDeviceRegistryProperty und SetupDiSetDeviceRegistryProperty rufen den Registrierungsschlüssel für jede angegebene Eigenschaft ab und legen sie fest. Der Parameter Property gibt die eigenschaft an, die abgerufen oder festgelegt werden soll. Der PropertyBuffer zeigt auf den Zielpuffer (beim Abrufen der Eigenschaft) oder auf den Quellpuffer (beim Festlegen der Eigenschaft) für die Eigenschaft.

Die Übereinstimmung zwischen Werten für den Property-Parameter und den tatsächlichen Eigenschaften lautet wie folgt.

Value für Property-Parameter	Device-Objekteigenschaft
SPDRP_CHARACTERISTICS	Gerätemerkmale
SPDRP_DEVTYPE	Gerätetyp
SPDRP_EXCLUSIVE	Exklusiv
SPDRP_SECURITY	Sicherheitsbeschreibung als SECURITY_DESCRIPTOR-Struktur
SPDRP_SECURITY_SDS	Sicherheitsbeschreibung als SDDL-Zeichenfolge

Beachten Sie, dass zwei verschiedene Möglichkeiten zum Abrufen oder Festlegen des Sicherheitsdeskriptors bereitgestellt werden. Sie können den SPDRP_SECURITY Wert angeben, um den Sicherheitsdeskriptor als SECURITY_DESCRIPTOR-Struktur zu behandeln, oder SPDRP_SECURITY_SDS, den Sicherheitsdeskriptor als SDDL-Zeichenfolge zu behandeln. Weitere Informationen zu SDDL-Zeichenfolgen finden Sie unter SDDL für Geräteobjekte.

Für Windows XP und höhere Betriebssysteme können Programme auch die Eigenschaftswerte für eine Gerätesetupklasse abrufen und festlegen. Verwenden Sie die Funktionen SetupDiGetClassRegistryProperty und SetupDiSetClassRegistryProperty , um die Eigenschaftswerte für eine Gerätesetupklasse abzurufen und festzulegen.

Weitere Informationen zur Verwendung der SetupDiXxx-Funktionen finden Sie unter Verwenden von Geräteinstallationsfunktionen.