ISensor::GetCategory method (sensorsapi.h)

Retrieves the identifier of the sensor category.

Syntax

HRESULT GetCategory(
  [out] SENSOR_CATEGORY_ID *pSensorCategory
);

Parameters

[out] pSensorCategory

Address of a SENSOR_CATEGORY_ID that receives the sensor category ID.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_UNEXPECTED
The sensor driver did not provide a category value. The PROPVARIANT returned will have its error value set to HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND).
E_POINTER
NULL was passed in for pSensorCategory.

Remarks

A SENSOR_CATEGORY_ID is a GUID that uniquely identifies the sensor category.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

See also

ISensor

Sensor Categories, Types, and Data Fields