Funzione SetupDiBuildClassInfoListExA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiBuildClassInfoListEx restituisce un elenco di GUID della classe di installazione che includono ogni classe installata nel sistema locale o in un sistema remoto.

Sintassi

WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

Parametri

[in] Flags

Flag usati per controllare l'esclusione delle classi dall'elenco. Se non vengono specificati flag, tutte le classi di installazione vengono incluse nell'elenco. Può essere una combinazione dei valori seguenti:

DIBCI_NOINSTALLCLASS

Escludere una classe se ha la voce di valore NoInstallClass nella relativa chiave del Registro di sistema.

DIBCI_NODISPLAYCLASS

Escludere una classe se ha la voce di valore NoDisplayClass nella relativa chiave del Registro di sistema.

[out, optional] ClassGuidList

Puntatore a un buffer che riceve un elenco di GUID della classe di installazione.

[in] ClassGuidListSize

Fornisce il numero di GUID nella matrice ClassGuildList.

[out] RequiredSize

Puntatore a una variabile che riceve il numero di GUID restituiti. Se questo numero è maggiore delle dimensioni del ClassGuidList, il numero indica la dimensione della matrice ClassGuidList per contenere l'elenco.

[in, optional] MachineName

Puntatore a una stringa con terminazione NULL contenente il nome di un computer remoto da cui recuperare le classi di installazione installate. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, questa funzione compila un elenco di classi installate nel computer 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

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 effettuando una chiamata a GetLastError.

Osservazioni

Nota

L'intestazione setupapi.h definisce SetupDiBuildClassInfoListEx 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

Vedere anche

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx

Condividi tramite