Funzione SetupDiGetHwProfileFriendlyNameA (setupapi.h)

La funzione SetupDiGetHwProfileFriendlyName recupera il nome descrittivo associato a un ID profilo hardware.

Sintassi

WINSETUPAPI BOOL SetupDiGetHwProfileFriendlyNameA(
  [in]            DWORD  HwProfile,
  [out]           PSTR   FriendlyName,
  [in]            DWORD  FriendlyNameSize,
  [out, optional] PDWORD RequiredSize
);

Parametri

[in] HwProfile

ID 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 stringa per ricevere il nome descrittivo.

[in] FriendlyNameSize

Dimensioni, in caratteri, del buffer FriendlyName .

[out, optional] RequiredSize

Puntatore a una variabile di tipo DWORD che riceve il numero di caratteri necessari per recuperare il nome descrittivo (incluso un terminatore NULL).

Valore restituito

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

Commenti

Chiamare SetupDiGetHwProfileFriendlyNameEx per ottenere il nome descrittivo di un ID profilo hardware in un computer remoto.

Nota

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

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileList