Função UPSWaitForStateChange (upssvc.h)
A função UPSWaitForStateChange aguarda até que um estado UPS especificado seja alterado ou até que um intervalo de tempo limite se especifique.
Sintaxe
void UPSWaitForStateChange(
[in] DWORD aCurrentState,
[in] DWORD anInterval
);
Parâmetros
[in] aCurrentState
Especifica o estado ups no qual aguardar. Quando o estado do sistema UPS é alterado do estado especificado para qualquer outro estado, a função retorna. O valor especificado pode ser um dos seguintes:
UPS_ONLINE
A energia fornecida pelo utilitário é normal.
UPS_ONBATTERY
A energia fornecida pelo utilitário é inadequada, e as baterias UPS estão descarregando.
UPS_LOWBATTERY
A energia fornecida pelo utilitário é inadequada, e as baterias UPS são criticamente baixas.
UPS_NOCOMM
A comunicação com a UPS não está estabelecida no momento.
[in] anInterval
Especifica um intervalo de tempo limite, em milissegundos, para a função. Se o estado UPS não tiver sido alterado do estado especificado quando o intervalo decorrer, a função retornará. Um valor infinite significa que o intervalo nunca decorre.
Retornar valor
Nenhum
Comentários
A função UPSWaitForStateChange deve aguardar até que o estado do UPS seja alterado do valor especificado por aCurrentState ou até que o tempo especificado por anInterval tenha decorrido, o que ocorrer primeiro.
Uma chamada para UPSCancelWait interrompe UPSWaitForStateChange e faz com que ele retorne.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | upssvc.h (inclua Upssvc.h) |