Metodo ISensor::GetCategory (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 l'identificatore della categoria del sensore.

Sintassi

HRESULT GetCategory(
  [out] SENSOR_CATEGORY_ID *pSensorCategory
);

Parametri

[out] pSensorCategory

Indirizzo di un SENSOR_CATEGORY_ID che riceve l'ID categoria del sensore.

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.
E_UNEXPECTED	Il driver del sensore non ha fornito un valore di categoria. Il valore di errore restituito da PROPVARIANT verrà impostato su HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND).The PROPVARIANT returned will have its error value set to HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND).
E_POINTER	Null è stato passato per pSensorCategory.

Osservazioni:

Un SENSOR_CATEGORY_ID è un GUID che identifica in modo univoco la categoria 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

categorie di sensori, tipi e campi dati