Metodo IPortableDeviceManager::GetDeviceFriendlyName (portabledeviceapi.h)

Articolo
03/01/2024

Recupera il nome descrittivo per il dispositivo.

Sintassi

HRESULT GetDeviceFriendlyName(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceFriendlyName,
  [in, out] DWORD   *pcchDeviceFriendlyName
);

Parametri

[in] pszPnPDeviceID

Puntatore a una stringa con terminazione null contenente l'ID Plug and Play del dispositivo. È possibile recuperare un elenco di nomi di Plug and Play di tutti i dispositivi connessi al computer chiamando GetDevices.

[in, out] pDeviceFriendlyName

Buffer allocato dal chiamante usato per contenere il nome descrittivo per il dispositivo. Per informazioni sulle dimensioni necessarie per questo parametro, chiamare prima questo metodo con questo parametro impostato su NULL e pcchDeviceFriendlyName impostato su 0; il metodo avrà esito positivo e imposta pcchDeviceFriendlyName sulle dimensioni del buffer necessarie per contenere il nome descrittivo del dispositivo, incluso il carattere di terminazione.

[in, out] pcchDeviceFriendlyName

In input, il numero massimo di caratteri che pDeviceFriendlyName può contenere, incluso il carattere di terminazione. In output, il numero di caratteri restituiti da pDeviceFriendlyName, incluso anche il carattere di terminazione.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer fornito non è abbastanza grande per contenere la descrizione del dispositivo. Fare riferimento al valore restituito in pcchDeviceDescription per le dimensioni necessarie.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	Impossibile trovare la descrizione del dispositivo.
S_OK	Il metodo è riuscito.
E_POINTER	Almeno uno degli argomenti necessari è un puntatore NULL .

Commenti

Un dispositivo non è necessario per supportare questo metodo. Se questo metodo non riesce a recuperare un nome, provare a richiedere la proprietà WPD_OBJECT_NAME dell'oggetto dispositivo (l'oggetto con l'ID WPD_DEVICE_OBJECT_ID ).

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceManager

IPortableDeviceManager::GetDevices

Condividi tramite