Funzione SetupDiSetClassRegistryPropertyW (setupapi.h)
La funzione SetupDiSetClassRegistryProperty imposta una proprietà della classe di dispositivo specificata nel Registro di sistema.
Sintassi
WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyW(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[in, optional] const BYTE *PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parametri
[in] ClassGuid
Puntatore al GUID che identifica la classe di dispositivo per cui deve essere impostata una proprietà.
[in] Property
Valore che identifica la proprietà da impostare, che deve essere uno dei seguenti:
SPCRP_CHARACTERISTICS
Il chiamante fornisce flag che specificano le caratteristiche del dispositivo per la classe. Per un elenco di flag di caratteristiche, vedere il parametro DeviceCharacteristics di IoCreateDevice. Le caratteristiche del dispositivo devono essere impostate quando la classe di dispositivo è installata e non devono essere modificate dopo l'installazione della classe di 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 modificata dopo l'installazione della classe di 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 l'accesso esclusivo è consentito o 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 di dispositivo.
SPCRP_LOWERFILTERS
(Windows Vista e versioni successive) Il chiamante fornisce un elenco di 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 di classe, vedere Installazione di un driver di filtro e classe INFInstall32.
SPCRP_SECURITY
Il chiamante fornisce il descrittore di sicurezza del dispositivo come struttura 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 di classe, vedere Installazione di un driver di filtro e classe INFInstall32.
[in, optional] PropertyBuffer
Puntatore a un buffer che fornisce la proprietà specificata. Questo parametro è facoltativo e può essere NULL.
[in] PropertyBufferSize
Dimensioni, in byte, del buffer PropertyBuffer .
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL contenente 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
La funzione restituisce TRUE se ha esito positivo. 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 di 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |
Vedi anche
SetupDiGetClassRegistryProperty