Funzione SetupDiClassGuidsFromNameA (setupapi.h)

La funzione SetupDiClassGuidsFromName recupera i GUID associati al nome della classe specificato. Questo elenco è basato sulle classi attualmente installate nel sistema.

Sintassi

WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
  [in]  PCSTR  ClassName,
  [out] LPGUID ClassGuidList,
  [in]  DWORD  ClassGuidListSize,
  [out] PDWORD RequiredSize
);

Parametri

[in] ClassName

Nome della classe per cui recuperare il 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

Fornisce un 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.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.

Commenti

Chiamare SetupDiClassGuidsFromNameEx per recuperare i GUID della classe per una classe in un computer remoto.

Nota

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid