UPSInit-Funktion (upssvc.h)

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

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 nicht identifizierter Fehler ist aufgetreten.

Hinweise

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 abschließen, einschließlich der folgenden:

• Öffnen eines Kommunikationspfads zur USV-Einheit
• Bestimmen des Anfangszustands der USV-Einheit
• Aktualisieren von UPS-Registrierungseinträgen
• Beginn der Überwachung der USV-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
Kopfzeile	upssvc.h (include Upssvc.h)

Weitere Informationen

UPSStop