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)

Weitere Informationen

UPSCancelWait