Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Use the UWP Sensor API instead.
The COM-based Sensor API is deprecated and should not be used in new applications. No additional features or enhancements are planned, and support will be limited.
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 |
|---|---|
|
The method succeeded. |
|
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). |
|
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 |