Funzione SetupDiGetClassDescriptionW (setupapi.h)

Articolo
11/20/2024

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

Sintassi

WINSETUPAPI BOOL SetupDiGetClassDescriptionW(
  [in]            const GUID *ClassGuid,
  [out]           PWSTR      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
set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

SetupDiGetINFClass

Condividi tramite