Funzione SetupDiSetClassRegistryPropertyW (setupapi.h)
La funzione SetupDiSetClassRegistryProperty
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 del dispositivo per cui 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 di 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 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 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 Installazione di un driver filtro e classe INFInstall32 sezione.
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 classi, vedere Installazione di un driver filtro e classe INFInstall32 sezione.
[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.
Cautela
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 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.
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 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 Windows XP e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione |
setupapi.h (include Setupapi.h) |
| libreria |
Setupapi.lib |
Vedere anche
SetupDiGetClassRegistryProperty