Funzione SetupDiClassNameFromGuidA (setupapi.h)

  • Articolo

La funzione SetupDiClassNameFromGuid recupera il nome della classe associato a un GUID di classe.

Sintassi

WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize
);

Parametri

[in] ClassGuid

Puntatore al GUID della classe per il nome della classe da recuperare.

[out] ClassName

Puntatore a un buffer che riceve la stringa con terminazione NULL contenente il nome della classe specificata dal puntatore nel parametro ClassGuid .

[in] ClassNameSize

Dimensioni, in caratteri, del buffer a cui punta il parametro ClassName . Le dimensioni massime, in caratteri, di un nome di classe con terminazione NULL sono MAX_CLASS_NAME_LEN. Per altre informazioni sulle dimensioni del nome della classe, vedere la sezione Osservazioni seguenti.

[out, optional] RequiredSize

Puntatore a una variabile che riceve il numero di caratteri necessari per archiviare il nome della classe NULL richiesta. Questo puntatore è facoltativo e può essere NULL.

Valore restituito

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

Commenti

Chiamare SetupDiClassNameFromGuidEx per recuperare il nome di una classe in un computer remoto.

SetupDiClassNameFromGuid non applica una restrizione sulla lunghezza del nome della classe che può restituire. Questa funzione restituisce le dimensioni necessarie per un nome di classe con terminazione NULL anche se è maggiore di MAX_CLASS_NAME_LEN. Tuttavia, MAX_CLASS_NAME_LEN è la lunghezza massima di un nome di classe con terminazione NULL valido. Un chiamante non deve mai avere un buffer maggiore di MAX_CLASS_NAME_LEN. Per altre informazioni sui nomi delle classi, vedere la descrizione della voce Classe di una versione INF.

Nota

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

Requisito Valore
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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx