Funzione SetupDiGetHwProfileFriendlyNameExA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiGetHwProfileFriendlyNameEx recupera il nome descrittivo associato a un ID profilo hardware in un computer locale o remoto.

Sintassi

WINSETUPAPI BOOL SetupDiGetHwProfileFriendlyNameExA(
  [in]            DWORD  HwProfile,
  [out]           PSTR   FriendlyName,
  [in]            DWORD  FriendlyNameSize,
  [out, optional] PDWORD RequiredSize,
  [in, optional]  PCSTR  MachineName,
                  PVOID  Reserved
);

Parametri

[in] HwProfile

Fornisce l'ID del profilo hardware associato al nome descrittivo da recuperare. Se questo parametro è 0, viene recuperato il nome descrittivo per il profilo hardware corrente.

[out] FriendlyName

Puntatore a un buffer di caratteri per ricevere il nome descrittivo.

[in] FriendlyNameSize

Dimensione, in caratteri, del buffer FriendlyName.

[out, optional] RequiredSize

Puntatore a una variabile per ricevere il numero di caratteri necessari per archiviare il nome descrittivo (incluso un carattere di terminazione NULL). Questo parametro è facoltativo e può essere NULL.

[in, optional] MachineName

Puntatore alla stringa con terminazione NULL contenente il nome di un computer remoto in cui risiede l'ID del profilo hardware. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, l'ID del profilo hardware si trova nel computer 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 effettuando una chiamata a GetLastError.

Osservazioni

Nota

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

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileListEx

Condividi tramite