Funzione SetupDiSetClassRegistryPropertyA (setupapi.h)
La funzione SetupDiSetClassRegistryProperty imposta una proprietà della classe di dispositivo specificata nel Registro di sistema.
Sintassi
WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[in, optional] const BYTE *PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in] ClassGuid
Puntatore al GUID che identifica la classe del dispositivo per la quale deve essere impostata una proprietà.
[in] Property
Valore che identifica la proprietà da impostare, che deve essere una delle seguenti:
SPCRP_CHARACTERISTICS
Il chiamante fornisce flag che specificano le caratteristiche del dispositivo per la classe . Per un elenco dei flag di caratteristiche, vedere il parametro DeviceCharacteristics di IoCreateDevice. Le caratteristiche del dispositivo devono essere impostate quando viene installata la classe del dispositivo e non devono essere modificate dopo l'installazione della classe del dispositivo.
SPCRP_DEVTYPE
Il chiamante fornisce il tipo di dispositivo per la classe . Per altre informazioni, vedere Specifica dei tipi di dispositivo. Il tipo di dispositivo deve essere impostato quando viene installata una classe di dispositivo e non deve essere modificato dopo l'installazione della classe del dispositivo.
SPCRP_EXCLUSIVE
Il chiamante fornisce un valore DWORD che specifica se gli utenti possono ottenere l'accesso esclusivo ai dispositivi per questa classe. Il valore specificato è 1 se è consentito l'accesso esclusivo oppure zero in caso contrario. L'impostazione esclusiva per un dispositivo deve essere impostata quando viene installata una classe di dispositivo e non deve essere modificata dopo l'installazione della classe del dispositivo.
SPCRP_LOWERFILTERS
(Windows Vista e versioni successive) Il chiamante fornisce un elenco REG_MULTI_SZ dei nomi dei servizi dei driver di filtro inferiori installati per la classe di installazione del dispositivo. Per altre informazioni su come installare un driver di filtro classi, vedere La sezione Installing a Filter Driver and INF ClassInstall32 .For more information about how to install a class filter driver, see Installing a Filter Driver and INF ClassInstall32 Section.
SPCRP_SECURITY
Il chiamante fornisce il descrittore di sicurezza del dispositivo come struttura di SECURITY_DESCRIPTOR in formato auto-relativo (descritto nella documentazione di Microsoft Windows SDK).
SPCRP_SECURITY_SDS
Il chiamante fornisce il descrittore di sicurezza del dispositivo come stringa di testo. Per informazioni sulle stringhe del descrittore di sicurezza, vedere Security Descriptor Definition Language (Windows). Per informazioni sul formato delle stringhe del descrittore di sicurezza, vedere Security Descriptor Definition Language (Windows).
SPCRP_UPPERFILTERS
(Windows Vista e versioni successive) Il chiamante fornisce un elenco REG_MULTI_SZ dei nomi dei servizi dei driver di filtro superiore installati per la classe di installazione del dispositivo. Per altre informazioni su come installare un driver di filtro classi, vedere La sezione Installing a Filter Driver and INF ClassInstall32 .For more information about how to install a class filter driver, see Installing a Filter Driver and INF ClassInstall32 Section.
[in, optional] PropertyBuffer
Puntatore a un buffer che fornisce la proprietà specificata. Questo parametro è facoltativo e può essere NULL.
[in] PropertyBufferSize
Dimensione, in byte, del buffer PropertyBuffer .
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL che contiene il nome di un sistema remoto in cui impostare la proprietà della classe di dispositivo specificata. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, la proprietà viene impostata sul nome del sistema locale.
Attenzione
L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
Reserved
Riservato, deve essere NULL.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.
Commenti
Il chiamante di questa funzione deve essere membro del gruppo Administrators.
Per determinare il tipo di dati per una proprietà della classe del dispositivo, chiamare SetupDiGetClassRegistryProperty.
Nota
L'intestazione setupapi.h definisce SetupDiSetClassRegistryProperty 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
Vedi anche
SetupDiGetClassRegistryProperty