Metodo IPortableDeviceManager::GetDeviceProperty (portabledeviceapi.h)

Articolo
03/05/2024

Recupera un valore della proprietà archiviato dal dispositivo nel computer. Queste non sono proprietà standard definite dai dispositivi portatili Windows.

Sintassi

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

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 tutti i dispositivi connessi al computer chiamando GetDevices.

[in] pszDevicePropertyName

Puntatore a una stringa con terminazione Null contenente il nome della proprietà da richiedere. Si tratta di nomi di proprietà personalizzati definiti da un produttore del dispositivo.

[in, out] pData

Buffer allocato dal chiamante per contenere i dati recuperati. Per ottenere le dimensioni necessarie, chiamare questo metodo con questo parametro impostato su NULL e pcbData impostato su zero e le dimensioni necessarie verranno recuperate in pcbData. Questa chiamata restituirà anche un errore che può essere ignorato. Vedere Valori restituiti.

[in, out] pcbData

Dimensione del buffer allocata o restituita da pData, in byte.

[in, out] pdwType

Costante che descrive il tipo di dati restituiti in pData. I valori per questo parametro sono gli stessi tipi usati per descrivere il parametro lpType della funzione Platform SDK RegQueryValueEx.

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
S_OK	Il metodo è riuscito.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il buffer fornito non è sufficientemente grande da contenere i dati richiesti. Questo risultato viene sempre restituito quando pData è NULL. È possibile ignorare questo risultato se si chiama il metodo per recuperare le dimensioni del buffer necessarie. Vedere la descrizione del parametro pData .
E_POINTER	Almeno uno degli argomenti obbligatori è un puntatore NULL .

Commenti

Questi valori di proprietà vengono archiviati durante l'installazione del dispositivo o archiviati da un dispositivo durante l'operazione in modo che possano essere salvati in modo permanente tra le sessioni di connessione. Un'applicazione deve conoscere il nome esatto della proprietà, specificata dal dispositivo stesso; pertanto, questo metodo è progettato per essere usato dagli sviluppatori di dispositivi che creano le proprie applicazioni.

Per ottenere le proprietà dei dispositivi portatili Windows dall'oggetto dispositivo, chiamare IPortableDeviceProperties::GetValues e specificare l'oggetto dispositivo con 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