Funzione UPSInit (upssvc.h)

  • Articolo

La funzione UPSInit inizializza un minidriver UPS, apre la comunicazione con l'unità UPS, aggiorna il Registro di sistema e fa in modo che il minidriver avvii il monitoraggio dell'unità UPS.

Sintassi

DWORD UPSInit();

Valore restituito

La funzione UPSInit restituisce uno dei valori DWORD seguenti:

Codice restituito Descrizione
UPS_INITOK
 Non sono stati rilevati errori durante l'inizializzazione.
UPS_INITREGISTRYERROR
 Errore durante l'accesso al Registro di sistema.
UPS_INITCOMMOPENERROR
 Errore durante l'apertura della porta COM.
UPS_INITCOMMSETUPERROR
 Errore durante la configurazione della porta COM.
UPS_INITUNKNOWNERROR
 Si è verificato un errore non identificato.

Commenti

La funzione UPSInit è la prima funzione esportata da un minidriver UPS chiamato dal servizio UPS. La funzione deve completare tutte le operazioni di inizializzazione per il minidriver, incluse le operazioni seguenti:

  • Apertura di un percorso di comunicazione all'unità UPS
  • Determinazione dello stato iniziale dell'unità UPS
  • Aggiornamento delle voci del Registro di sistema UPS
  • Inizio del monitoraggio dell'unità UPS
Se la funzione UPSInit restituisce un valore diverso da UPS_INITOK, il servizio UPS chiama immediatamente la funzione UPSStop .

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione upssvc.h (include Upssvc.h)

Vedi anche

UPSStop