Freigeben über


UPSInit-Funktion (upssvc.h)

Die UPSInit Funktion initialisiert einen UPS Minidriver, öffnet die Kommunikation mit der UPS-Einheit, aktualisiert die Registrierung und bewirkt, dass der Minidriver die Überwachung der UPS-Einheit startet.

Syntax

DWORD UPSInit();

Rückgabewert

Die UPSInit Funktion gibt einen der folgenden DWORD-Werte zurück:

Rückgabecode Beschreibung
UPS_INITOK
Während der Initialisierung sind keine Fehler aufgetreten.
UPS_INITREGISTRYERROR
Fehler beim Zugriff auf die Registrierung.
UPS_INITCOMMOPENERROR
Fehler beim Öffnen des COM-Ports.
UPS_INITCOMMSETUPERROR
Fehler beim Einrichten des COM-Ports.
UPS_INITUNKNOWNERROR
Ein unbekannter Fehler ist aufgetreten.

Bemerkungen

Die UPSInit Funktion ist die erste Funktion, die von einem UPS-Minidriver exportiert wird, der vom UPS-Dienst aufgerufen wird. Die Funktion muss alle Initialisierungsvorgänge für den Minidriver ausführen, einschließlich der folgenden:

  • Öffnen eines Kommunikationspfads zur UPS-Einheit
  • Bestimmen des Anfangszustands der UPS-Einheit
  • Aktualisieren UPS-Registrierungseinträge
  • Beginn der Überwachung der UPS-Einheit
Wenn die UPSInit-funktion einen anderen Wert als UPS_INITOK zurückgibt, ruft der UPS-Dienst sofort die UPSStop--Funktion auf.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- upssvc.h (include Upssvc.h)

Siehe auch

UPSStop-