Metodo ISensor::GetProperties (sensorsapi.h)

Articolo
03/01/2024

Recupera più proprietà del sensore.

Sintassi

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Parametri

[in] pKeys

Puntatore a un'interfaccia IPortableDeviceKeyCollection contenente l'insieme PROPERTYKEY per i valori delle proprietà richiesti. Impostare su NULL per recuperare tutte le proprietà supportate.

[out] ppProperties

Indirizzo di un puntatore IPortableDeviceValues che riceve il puntatore ai valori delle proprietà richieste.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
S_FALSE	Il driver del sensore non supporta almeno una delle proprietà specificate. Ogni proprietà PROPVARIANT non supportata restituita tramite l'interfaccia IPortableDeviceValues avrà il valore di errore impostato su HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	NULL è stato passato in per ppProperties.

Commenti

Questo metodo consente di recuperare i valori di più proprietà, ad esempio il sensore make, il modello e il numero di serie, eseguendo una singola chiamata. Per recuperare una singola proprietà, chiamare ISensor::GetProperty.

Le interfacce IPortableDeviceKeyCollection e IPortableDeviceValues sono definite dall'API Dispositivi portatili Windows.

Esempio

Per un esempio di come recuperare le proprietà da un sensore, vedere Impostazione e recupero delle proprietà del sensore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	sensorsapi.h
Libreria	Sensorsapi.lib
DLL	Sensorsapi.dll

Vedi anche

ISensor

Proprietà del sensore

SetProperties

Condividi tramite