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 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 stringhe per ricevere il nome descrittivo.
[in] FriendlyNameSize
Dimensione, 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 carattere di terminazione 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
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 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 |