Funzione SetupDiSetDeviceRegistryPropertyA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiSetDeviceRegistryProperty imposta una proprietà del dispositivo Plug and Play per un dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiSetDeviceRegistryPropertyA(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData,
  [in]           DWORD            Property,
  [in, optional] const BYTE       *PropertyBuffer,
  [in]           DWORD            PropertyBufferSize
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene un elemento di informazioni sul dispositivo che rappresenta il dispositivo per cui impostare una proprietà del dispositivo Plug and Play.

[in, out] DeviceInfoData

Puntatore a una struttura di SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Se la proprietà ClassGuid è impostata, DeviceInfoData.classGuid viene impostato al ritorno alla nuova classe per il dispositivo.

[in] Property

Uno dei valori seguenti, che identifica la proprietà da impostare. Per le descrizioni di questi valori, vedere SetupDiGetDeviceRegistryProperty.

SPDRP_CONFIGFLAGS
SPDRP_EXCLUSIVE
SPDRP_FRIENDLYNAME
SPDRP_LOCATION_INFORMATION
SPDRP_LOWERFILTERS
SPDRP_REMOVAL_POLICY_OVERRIDE
SPDRP_SECURITY
SPDRP_SECURITY_SDS
SPDRP_UI_NUMBER_DESC_FORMAT
SPDRP_UPPERFILTERS

Nota

SPDRP_HARDWAREID o SPDRP_COMPATIBLEIDS può essere usato solo quando DeviceInfoData rappresenta un dispositivo enumerato radice. Per altri dispositivi, il driver del bus segnala id hardware e compatibili durante l'enumerazione di un dispositivo figlio dopo aver ricevuto IRP_MN_QUERY_ID.

I valori seguenti sono riservati per l'uso dal sistema operativo e non possono essere usati nel parametro property :

SPDRP_ADDRESS
SPDRP_BUSNUMBER
SPDRP_BUSTYPEGUID
SPDRP_CHARACTERISTICS
SPDRP_CAPABILITIES
SPDRP_CLASS
SPDRP_CLASSGUID
SPDRP_DEVICE_POWER_DATA
SPDRP_DEVICEDESC
SPDRP_DEVTYPE
SPDRP_DRIVER
SPDRP_ENUMERATOR_NAME
SPDRP_INSTALL_STATE
SPDRP_LEGACYBUSTYPE
SPDRP_LOCATION_PATHS
SPDRP_MFG
SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
SPDRP_REMOVAL_POLICY
SPDRP_REMOVAL_POLICY_HW_DEFAULT
SPDRP_SERVICE
SPDRP_UI_NUMBER

[in, optional] PropertyBuffer

Puntatore a un buffer che contiene i nuovi dati per la proprietà . Se la proprietà viene cancellata, questo puntatore deve essere NULL e PropertyBufferSize deve essere zero.

[in] PropertyBufferSize

Dimensione, in byte, di PropertyBuffer. Se PropertyBuffer è NULL, questo campo deve essere zero.

Valore restituito

Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Osservazioni

Il chiamante di questa funzione deve essere membro del gruppo Administrators.

Impossibile impostare la proprietà class name perché si basa sul GUID della classe corrispondente e viene aggiornata automaticamente quando tale proprietà viene modificata. Quando la proprietà ClassGUID viene modificata, SetupDiSetDeviceRegistryProperty pulisce automaticamente tutte le chiavi software associate al dispositivo.

Nota

L'intestazione setupapi.h definisce SetupDiSetDeviceRegistryProperty come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	setupapi.h (include Setupapi.h)
libreria	Setupapi.lib

Vedere anche

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

Condividi tramite