UPSWaitForStateChange-Funktion (upssvc.h)
Die UPSWaitForStateChange-Funktion wartet, bis sich ein festgelegter UPS-Zustand ändert oder bis ein Timeoutintervall verstreicht.
Syntax
void UPSWaitForStateChange(
[in] DWORD aCurrentState,
[in] DWORD anInterval
);
Parameter
[in] aCurrentState
Gibt den USV-Zustand an, für den gewartet werden soll. Wenn der Zustand des USV-Systems vom angegebenen Zustand in einen anderen Wechsel erfolgt, wird die Funktion zurückgegeben. Der angegebene Wert kann einer der folgenden sein:
UPS_ONLINE
Die vom Hilfsprogramm bereitgestellte Stromversorgung ist normal.
UPS_ONBATTERY
Die Stromversorgung ist unzureichend, und die USV-Batterien entladen sich.
UPS_LOWBATTERY
Die Stromversorgung ist unzureichend, und die USV-Batterien sind kritisch niedrig.
UPS_NOCOMM
Die Kommunikation mit der USV ist derzeit nicht eingerichtet.
[in] anInterval
Gibt ein Timeoutintervall in Millisekunden für die Funktion an. Wenn sich der UPS-Zustand nicht vom angegebenen Zustand geändert hat, wenn das Intervall verstrichen ist, gibt die Funktion zurück. Ein Wert von INFINITE bedeutet, dass das Intervall nie verstreicht.
Rückgabewert
Keine
Bemerkungen
Die UPSWaitForStateChange-Funktion muss warten, bis sich entweder der Zustand der USV von dem von aCurrentState angegebenen Wert ändert, oder bis die von einerInterval angegebene Zeit verstrichen ist, je nachdem, was zuerst auftritt.
Ein Aufruf von UPSCancelWait unterbricht UPSWaitForStateChange und bewirkt, dass es zurückgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | upssvc.h (include Upssvc.h) |