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)

另请参阅

UPSCancelWait