UPSWaitForStateChange-Funktion (upssvc.h)
Die UPSWaitForStateChange--Funktion wartet, bis sich ein angegebener UPS-Zustand ändert oder bis ein Timeoutintervall verstrichen ist.
Syntax
void UPSWaitForStateChange(
[in] DWORD aCurrentState,
[in] DWORD anInterval
);
Parameter
[in] aCurrentState
Gibt den UPS-Zustand an, auf den gewartet werden soll. Wenn sich der Zustand des UPS-Systems von dem angegebenen Zustand in einen anderen Zustand ändert, wird die Funktion zurückgegeben. Der angegebene Wert kann eine der folgenden Sein:
UPS_ONLINE
Hilfsstrom ist normal.
UPS_ONBATTERY
Versorgungsleistung ist unzureichend, und die USV-Batterien werden entladen.
UPS_LOWBATTERY
Versorgungsleistung ist unzureichend, und die USV-Batterien sind kritisch niedrig.
UPS_NOCOMM
Die Kommunikation mit dem UPS ist derzeit nicht eingerichtet.
[in] anInterval
Gibt ein Timeoutintervall in Millisekunden für die Funktion an. Wenn sich der UPS-Zustand beim Verstreichen des Intervalls nicht vom angegebenen Zustand geändert hat, wird die Funktion zurückgegeben. Ein Wert von INFINITE bedeutet, dass das Intervall nie verstrichen ist.
Rückgabewert
Nichts
Bemerkungen
Die UPSWaitForStateChange--Funktion muss warten, bis sich der Zustand der UPS von dem wert ändert, der durch aCurrentStateangegeben wurde, oder bis die durch anInterval angegebene Zeit verstrichen ist, je nachdem, was zuerst eintritt.
Ein Aufruf von UPSCancelWait unterbricht UPSWaitForStateChange und bewirkt, dass er zurückgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | upssvc.h (include Upssvc.h) |