Condividi tramite


Metodo IPortableDeviceManager::GetDeviceManufacturer (portabledeviceapi.h)

Recupera il nome del produttore del dispositivo.

Sintassi

HRESULT GetDeviceManufacturer(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceManufacturer,
  [in, out] DWORD   *pcchDeviceManufacturer
);

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] pDeviceManufacturer

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

[in, out] pcchDeviceManufacturer

In input il numero massimo di caratteri che pDeviceManufacturer può contenere, non incluso il carattere di terminazione. In output il numero di caratteri restituiti da pDeviceManufacturer, non incluso 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 .

Requisiti

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

Vedi anche

Interfaccia IPortableDeviceManager

IPortableDeviceManager::GetDevices