[This function is not supported and may be altered or unavailable in the future. Instead, use the GetLastInputInfo function.]
Begins monitoring inactivity.
Syntax
DWORD WINAPI BeginIdleDetection(
_IDLECALLBACK pfnCallback,
DWORD dwIdleMin,
DWORD dwReserved
);
Parameters
pfnCallback
The function that is called when the idle state changes. This callback is defined as follows:
typedef void (WINAPI* _IDLECALLBACK) (DWORD dwState);
#define STATE_USER_IDLE_BEGIN 1
#define STATE_USER_IDLE_END 2
dwIdleMin
The number of minutes of inactivity before the call is made to the callback function.
dwReserved
This parameter must be set to zero.
Return value
Returns 0 if the function succeeds; otherwise, it returns an error code. For example, if dwReserved is anything other than 0, ERROR_INVALID_DATA is returned.
Remarks
This function has no associated import library or header file; you must call it using the LoadLibrary and GetProcAddress functions. This function is not exported by name; specify ordinal 3 when calling GetProcAddress.
Requirements
| Requirement | Value |
|---|---|
| DLL | Msidle.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
