Funzione UPSInit (upssvc.h)

La funzione UPSInit inizializza un minidriver UPS, apre la comunicazione con l'unità UPS, aggiorna il Registro di sistema e fa sì 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.

Osservazioni

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 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	upssvc.h (include Upssvc.h)

Vedere anche

UPSStop