Funzione SetupDiClassNameFromGuidExA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiClassNameFromGuidEx recupera il nome della classe associato a un GUID di classe. La classe può essere installata in un computer locale o remoto.

Sintassi

WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
  [in]            const GUID *ClassGuid,
  [out]           PSTR       ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCSTR      MachineName,
                  PVOID      Reserved
);

Parametri

[in] ClassGuid

GUID della classe del nome della classe da recuperare.

[out] ClassName

Puntatore a un buffer di stringa che riceve il nome con terminazione NULL della classe per il GUID specificato.

[in] ClassNameSize

Dimensioni, in caratteri, del buffer ClassName .

[out, optional] RequiredSize

Numero di caratteri necessari per archiviare il nome della classe (incluso un valore Null di terminazione). RequiredSize è sempre minore di MAX_CLASS_NAME_LEN.

[in, optional] MachineName

Puntatore a una stringa con terminazione NULL contenente il nome di un sistema remoto in cui è installata la classe . Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, viene usato il nome del sistema locale.

Cautela

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

Nota

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid

Condividi tramite