Share via

Funzione SetupDiClassNameFromGuidExW (setupapi.h)

  • Articolo

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 SetupDiClassNameFromGuidExW(
  [in]            const GUID *ClassGuid,
  [out]           PWSTR      ClassName,
  [in]            DWORD      ClassNameSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

Parametri

[in] ClassGuid

GUID della classe del nome della classe da recuperare.

[out] ClassName

Puntatore a un buffer stringa che riceve il nome null-terminato 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 terminante). 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.

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

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

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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid