Funzione SetupDiBuildClassInfoListExA (setupapi.h)

  • Articolo

La funzione SetupDiBuildClassInfoListEx restituisce un elenco di GUID della classe di installazione che include 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 utilizzati 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 del 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 di 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.

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

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

Commenti

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 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 Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (include Setupapi.h)
Libreria Setupapi.lib

Vedi anche

SetupDiBuildClassInfoList

SetupDiGetClassDescriptionEx