Funzione SetupDiClassNameFromGuidA (setupapi.h)

Articolo
11/20/2024

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 da recuperare per il nome della classe.

[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. La dimensione massima, in caratteri, di un nome di classe con terminazione NULL è MAX_CLASS_NAME_LEN. Per altre informazioni sulle dimensioni del nome della classe, vedere la sezione osservazioni seguente.

[out, optional] RequiredSize

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

Valore restituito

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

Osservazioni

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 sezione 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 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

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx

Condividi tramite