Funzione SetupDiGetClassRegistryPropertyA (setupapi.h)
La funzione SetupDiGetClassRegistryProperty
Sintassi
WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyA(
[in] const GUID *ClassGuid,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in] ClassGuid
Puntatore a un GUID che rappresenta la classe di installazione del dispositivo per la quale deve essere recuperata una proprietà.
[in] Property
Valore che identifica la proprietà da recuperare. Deve essere uno dei valori seguenti:
SPCRP_CHARACTERISTICS
La funzione restituisce i flag che indicano le caratteristiche del dispositivo per la classe . Per un elenco dei flag di caratteristiche, vedere il parametro
SPCRP_DEVTYPE
La funzione restituisce un valore DWORD che rappresenta il tipo di dispositivo per la classe . Per altre informazioni, vedere Specifica dei tipi di dispositivo.
SPCRP_EXCLUSIVE
La funzione restituisce un valore DWORD che indica se gli utenti possono ottenere l'accesso esclusivo ai dispositivi per questa classe. Il valore restituito è uno se è consentito l'accesso esclusivo o zero in caso contrario.
SPCRP_LOWERFILTERS
(Windows Vista e versioni successive) La funzione restituisce un elenco REG_MULTI_SZ dei nomi dei servizi dei driver di filtro inferiori installati per la classe di installazione del dispositivo.
SPCRP_SECURITY
La funzione restituisce il descrittore di sicurezza del dispositivo come struttura SECURITY_DESCRIPTOR in formato auto-relativo (descritto nella documentazione di Microsoft Windows SDK).
SPCRP_SECURITY_SDS
La funzione restituisce 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) La funzione restituisce un elenco di REG_MULTI_SZ dei nomi dei servizi dei driver di filtro superiore installati per la classe di installazione del dispositivo.
[out, optional] PropertyRegDataType
Puntatore a una variabile di tipo DWORD che riceve il tipo di dati della proprietà come uno dei tipi di dati del Registro di sistema con prefisso REG_. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, SetupDiGetClassRegistryProperty non restituisce il tipo di dati.
[out] PropertyBuffer
Puntatore a un buffer che riceve la proprietà richiesta.
[in] PropertyBufferSize
Dimensioni, in byte, del buffer PropertyBuffer
[out, optional] RequiredSize
Puntatore a una variabile di tipo DWORD che riceve le dimensioni richieste, in byte, del buffer PropertyBuffer
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL contenente il nome di un sistema remoto da cui recuperare la proprietà della classe di dispositivo specificata. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, la proprietà viene recuperata dal 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
Nota
L'intestazione setupapi.h definisce SetupDiGetClassRegistryProperty 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 | DesktopFor universal, chiamare CM_Get_Class_Registry_Property |
| intestazione |
setupapi.h (include Setupapi.h) |
| libreria |
Setupapi.lib |
Vedere anche
SetupDiGetDeviceRegistryProperty