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 が中断され、返されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | upssvc.h (Upssvc.h を含む) |