Eigenschappen van apparaatobjectregister instellen na installatie

Een gebruikersmodusprogramma kan de installatiefuncties van het apparaat gebruiken om de registerinstellingen op te halen of in te stellen voor de eigenschappen van het apparaatobject van een stuurprogramma. Normaal gesproken worden deze functies gebruikt door installatiesoftware, maar ze kunnen worden gebruikt door elk gebruikersmodusprogramma. (Het programma moet worden uitgevoerd door een gebruiker met beheerderstoegang.)

De functies SetupDiGetDeviceRegistryProperty en SetupDiSetDeviceRegistryProperty krijgen en instellen de registersleutel voor elke opgegeven eigenschap. De parameter Eigenschap geeft de eigenschap op die moet worden get of ingesteld. De PropertyBuffer verwijst naar de doelbuffer (bij het ophalen van de eigenschap) of bronbuffer (bij het instellen van de eigenschap) voor de eigenschap.

De correspondentie tussen de waarden voor de parameter Eigenschap en de werkelijke eigenschappen is als volgt.

Waarde voor eigenschapsparameter	Eigenschap Apparaatobject
SPDRP_CHARACTERISTICS	Apparaatkenmerken
SPDRP_DEVTYPE	Apparaattype
SPDRP_EXCLUSIVE	Exclusief
SPDRP_SECURITY	Beveiligingsdescriptor als een SECURITY_DESCRIPTOR structuur
SPDRP_SECURITY_SDS	Beveiligingsdescriptor als een SDDL-tekenreeks

Houd er rekening mee dat er twee verschillende manieren worden geboden om de beveiligingsdescriptor op te halen of in te stellen. U kunt de SPDRP_SECURITY-waarde opgeven om de beveiligingsdescriptor te behandelen als een SECURITY_DESCRIPTOR structuur of SPDRP_SECURITY_SDS om de beveiligingsdescriptor te behandelen als een SDDL-tekenreeks. Zie SDDL voor apparaatobjecten voor meer informatie over SDDL-tekenreeksen.

Voor Windows XP- en latere besturingssystemen kunnen programma's ook de eigenschapswaarden voor een apparaatinstallatieklasse ophalen en instellen. Gebruik de functies SetupDiGetClassRegistryProperty en SetupDiSetClassRegistryProperty om de eigenschapswaarden voor een apparaatinstallatieklasse op te halen en in te stellen.

Voor meer informatie over het gebruik van de SetupDiXxx functies, zie Device Installation Functions gebruiken.