Funzione SetupDiGetClassRegistryPropertyA (setupapi.h)

La funzione SetupDiGetClassRegistryProperty recupera una proprietà per una classe di installazione del dispositivo specificata dal Registro di sistema.

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 flag che indicano le caratteristiche del dispositivo per la classe . Per un elenco dei flag di caratteristiche, vedere il parametro DeviceCharacteristics in IoCreateDevice.

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 di 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 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

Dimensione, 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 . Se il buffer PropertyBuffer è troppo piccolo e RequiredSize non è NULL, la funzione imposta RequiredSize sulla dimensione minima del buffer necessaria per ricevere la proprietà richiesta.

[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.

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

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 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	DesktopFor universal, chiamare CM_Get_Class_Registry_Property
Intestazione	setupapi.h (include Setupapi.h)
Libreria	Setupapi.lib

Vedi anche

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty