Condividi tramite


Funzione SetupDiGetClassDescriptionA (setupapi.h)

La funzione SetupDiGetClassDescription recupera la descrizione della classe associata al GUID della classe di installazione specificata.

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 le dimensioni, in caratteri, necessarie per archiviare la descrizione della classe (incluso un terminatore NULL). RequiredSize è sempre minore di LINE_LEN. Questo parametro è facoltativo e può 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

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

   
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (includere Setupapi.h)
Libreria Setupapi.lib

Vedi anche

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

SetupDiGetINFClass