Funzione SetupDiGetClassDescriptionA (setupapi.h)
La funzione SetupDiGetClassDescription
Sintassi
WINSETUPAPI BOOL SetupDiGetClassDescriptionA(
[in] const GUID *ClassGuid,
[out] PSTR ClassDescription,
[in] DWORD ClassDescriptionSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] ClassGuid
GUID della classe di installazione la cui descrizione deve essere recuperata.
[out] ClassDescription
Puntatore a un buffer di caratteri che riceve la descrizione della classe.
[in] ClassDescriptionSize
Dimensioni, in caratteri, del buffer classDescription
[out, optional] RequiredSize
Puntatore alla variabile di tipo DWORD che riceve la dimensione, in caratteri, necessaria per archiviare la descrizione della classe (incluso un carattere di terminazione NULL). RequiredSize è sempre minore di LINE_LEN. Questo parametro è facoltativo e può 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
Chiamare SetupDiGetClassDescriptionEx per recuperare la descrizione di una classe di installazione installata in un computer remoto.
Nota
L'intestazione setupapi.h definisce SetupDiGetClassDescription 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 Microsoft Windows 2000 e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione |
setupapi.h (include Setupapi.h) |
| libreria |
Setupapi.lib |