Compartilhar via

Função UPSInit (upssvc.h)

  • Artigo

A função UPSInit inicializa um minidriver UPS, abre a comunicação com a unidade UPS, atualiza o registro e faz com que o minidriver comece a monitorar a unidade UPS.

Sintaxe

DWORD UPSInit();

Retornar valor

A função UPSInit retorna um dos seguintes valores DWORD:

Código de retorno Descrição
UPS_INITOK
 Nenhum erro foi encontrado durante a inicialização.
UPS_INITREGISTRYERROR
 Ocorreu um erro ao acessar o registro.
UPS_INITCOMMOPENERROR
 Ocorreu um erro ao abrir a porta COM.
UPS_INITCOMMSETUPERROR
 Ocorreu um erro ao configurar a porta COM.
UPS_INITUNKNOWNERROR
 Ocorreu um erro não identificado.

Comentários

A função UPSInit é a primeira função exportada por um minidriver UPS chamado pelo serviço UPS. A função deve concluir todas as operações de inicialização para o minidriver, incluindo o seguinte:

  • Abrindo um caminho de comunicação para a unidade UPS
  • Determinando o estado inicial da unidade UPS
  • Atualizando entradas do registro UPS
  • Iniciando o monitoramento da unidade UPS
Se a função UPSInit retornar um valor diferente de UPS_INITOK, o serviço UPS chamará imediatamente a função UPSStop .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho upssvc.h (inclua Upssvc.h)

Confira também

UPSStop