UPSWaitForStateChange 函数 (upssvc.h)
UPSWaitForStateChange 函数将等待指定的 UPS 状态更改或超时间隔结束。
语法
void UPSWaitForStateChange(
[in] DWORD aCurrentState,
[in] DWORD anInterval
);
参数
[in] aCurrentState
指定要等待的 UPS 状态。 当 UPS 系统的状态从指定状态更改为任何其他状态时,函数将返回 。 指定的值可以是下列值之一:
UPS_ONLINE
公用电源正常。
UPS_ONBATTERY
公用电源不足,UPS 电池正在放电。
UPS_LOWBATTERY
公用电源不足,UPS 电池严重不足。
UPS_NOCOMM
目前尚未与 UPS 建立通信。
[in] anInterval
指定函数的超时间隔(以毫秒为单位)。 如果在间隔过后,UPS 状态未从指定的状态更改,则函数将返回 。 INFINITE 值表示间隔永远不会经过。
返回值
无
备注
UPSWaitForStateChange 函数必须等待,直到 UPS 的状态从由一个CurrentState 指定的值更改,或直到经过由Interval 指定的时间,以先发生者为准。
调用 UPSCancelWait 会中断 UPSWaitForStateChange 并使其返回。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | upssvc.h (包括 Upssvc.h) |