Metodo ISensor::GetProperties (sensorsapi.h)

Importante

Usare invece l'API sensore UWP .

L'API del sensore basata su COM è deprecata e non deve essere usata nelle nuove applicazioni. Non sono pianificate funzionalità o miglioramenti aggiuntivi e il supporto sarà limitato.

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 della proprietà richiesti.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Codice restituito	Description
S_OK	Il metodo è riuscito.
S_FALSE	Il driver del sensore non supporta almeno una delle proprietà specificate. Ogni proprietà NON supportata PROPVARIANT restituita tramite l'interfaccia IPortableDeviceValues avrà il relativo valore di errore impostato su HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).Each unsupported property returned through the IPortableDeviceValues interface will have its error value set to HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	NULL è stato passato per ppProperties.

Osservazioni:

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

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

Esempi

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

Requisiti

Requisito	Value
Client minimo supportato	Windows 7 [solo applicazioni desktop]
Server minimo supportato	Nessuna supportata
Piattaforma di destinazione	Windows
Header	sensorsapi.h
Library	Sensorsapi.lib
DLL	Sensorsapi.dll

Vedere anche

ISensor

Proprietà del sensore

SetProperties