Funzione UPSInit (upssvc.h)

La funzione UPSInit inizializza un minidriver UPS, apre la comunicazione all'unità UPS, aggiorna il Registro di sistema e causa l'avvio del minidriver per avviare il monitoraggio dell'unità UPS.

Sintassi

DWORD UPSInit();

Valore restituito

La funzione UPSInit restituisce uno dei valori DWORD seguenti:

Codice restituito Descrizione
UPS_INITOK
Nessun errore durante l'inizializzazione.
UPS_INITREGISTRYERROR
Si è verificato un errore durante l'accesso al Registro di sistema.
UPS_INITCOMMOPENERROR
Errore durante l'apertura della porta COM.
UPS_INITCOMMSETUPERROR
Si è verificato un 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, incluso quanto segue:

  • 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

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

Vedi anche

UPSStop