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 的狀態從 aCurrentState 所指定的值變更,或直到由Interval 指定的時間經過為止,才會先發生。
UPSCancelWait 的呼叫會中斷 UPSWaitForStateChange,並導致它傳回。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | upssvc.h (包含 Upssvc.h) |