Funzione SetupDiClassGuidsFromNameExA (setupapi.h)

  • Articolo

La funzione SetupDiClassGuidsFromNameEx recupera i GUID associati al nome della classe specificato. Questo elenco risultante contiene le classi attualmente installate in un computer locale o remoto.

Sintassi

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

Parametri

[in] ClassName

Nome della classe per cui recuperare i GUID della classe.

[out] ClassGuidList

Puntatore a una matrice per ricevere l'elenco di GUID associati al nome della classe specificato.

[in] ClassGuidListSize

Numero di GUID nella matrice ClassGuidList .

[out] RequiredSize

Puntatore a una variabile che riceve il numero di GUID associati al nome della classe. Se questo numero è maggiore delle dimensioni del buffer ClassGuidList , il numero indica la dimensione della matrice per archiviare tutti i GUID.

[in, optional] MachineName

Puntatore a una stringa con terminazione NULL contenente il nome di un sistema remoto da cui recuperare i GUID. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, viene usato il nome del sistema 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

Non è garantito che i nomi di classe siano univoci; solo i GUID sono univoci. Pertanto, un nome di classe può restituire più di un GUID.

Nota

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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx