ISensor::SetEventInterest method (sensorsapi.h)

Specifies the list of sensor events to receive.

Syntax

HRESULT SetEventInterest(
  [in] GUID  *pValues,
  [in] ULONG count
);

Parameters

[in] pValues

Pointer to an array of GUIDs. Each GUID represents an event to receive. Set to NULL to receive all data-updated events and all custom events.

[in] count

The count of GUIDs in the array pointed to by pValues. Set to zero when pValues is NULL.

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.

Remarks

Each sensor event is represented by a GUID. This method takes, as an array of GUIDs, the list of events that you want to receive.

Examples

For an example of how to set event interest, see Using Sensor API Events.

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

GetEventInterest

ISensor