Metodo IPortableDeviceManager::GetDeviceDescription (portabledeviceapi.h)
Recupera la descrizione di un dispositivo.
Sintassi
HRESULT GetDeviceDescription(
[in] LPCWSTR pszPnPDeviceID,
[in, out] WCHAR *pDeviceDescription,
[in, out] DWORD *pcchDeviceDescription
);
Parametri
[in] pszPnPDeviceID
Puntatore a una stringa con terminazione Null contenente l'ID Plug and Play del dispositivo. È possibile recuperare un elenco di Plug and Play nomi di dispositivi attualmente connessi chiamando GetDevices.
[in, out] pDeviceDescription
Buffer allocato dal chiamante per contenere il nome della descrizione utente del dispositivo. Il chiamante deve allocare la memoria per questo parametro. Per informazioni sulle dimensioni necessarie per questo parametro, chiamare prima questo metodo con questo parametro impostato su NULL e pcchDeviceDescription impostato su 0; il metodo avrà esito positivo e imposterà pcchDeviceDescription sulle dimensioni del buffer necessarie per contenere il nome descrittivo del dispositivo, incluso il carattere di terminazione.
[in, out] pcchDeviceDescription
Numero di caratteri (non incluso il carattere di terminazione) in pDeviceDescription. In input, la lunghezza massima di pDeviceDescription; nell'output la lunghezza della stringa restituita in pDeviceDescription.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il buffer fornito non è sufficientemente grande da contenere la descrizione del dispositivo. Fare riferimento al valore restituito in pcchDeviceDescription per le dimensioni necessarie. |
|
Impossibile trovare la descrizione del dispositivo. |
|
Il metodo è riuscito. |
|
Almeno uno degli argomenti obbligatori è un puntatore NULL . |
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | portabledeviceapi.h |
| Libreria | PortableDeviceGUIDs.lib |