Funzione SetupDiGetHwProfileFriendlyNameExA (setupapi.h)

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 del 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 che contiene 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.

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

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

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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

Vedi anche

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileListEx