Zum Hauptinhalt springen

WinShutdownBlock

obj -> WinShutdownBlock([alpha1]) : int;​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Beenden der Windows-Sitzung verhindern

Details

Mit dem neuen Befehl WinShutdownBlock kann verhindert werden, dass Windows die Sitzung beendet. Er sollte nur dann verwendet werden, wenn eine Operation in Verarbeitung ist, die abgeschlossen werden muss.

info

Dieser Befehl verhindert nicht das Beenden des Clients mittels Taskmanager.

Als (obj) muss der Deskriptor auf ein Fenster-Objekt ( Frame , AppFrame , MdiFrame oder TrayFrame ) übergeben werden. Die Fenster-Erstellung muss bereits abgeschlossen sein. Dies ist der Fall, wenn das Ereignis EvtCreated durchlaufen wurde.

Das optional Argument (alpha1) enthält die Nachricht, die im Abmeldebildschirm von Windows bei der blockierenden Anwendung angezeigt wird.

  • : Die Nachricht sollte möglichst kurz und prägnant sein.

Fehlt das Argument (alpha1) oder ist es leer, wird die Blockierung für das Fenster (obj) wieder aufgehoben.

Der Rückgabewert der Anwesiung kann mit folgenden Konstanten verglichen werden:

  • _ErrOk: Der Befehl wurde erfolgreich durchgeführt.
  • _ErrUnavailable: Die Funktion steht nicht zur Verfügung. Für die Ausführung wird Windows Vista vorausgesetzt.
  • _ErrGeneric: Es ist ein unerwarteter Fehler aufgetreten.

Beispiele:

// Beenden blockieren
$Frame->WinShutdownBlock('Datenspeicherung abschließen');

// Operation durchführen
...

// Beenden freigeben
$Frame->WinShutdownBlock();

Mögliche Laufzeitfehler:

  • _ErrHdlInvalid: Der in (obj) übergebene Deskriptor ist ungültig, ist kein Fenster-Objekt oder die Blockierung für das Fenster-Objekt wurde bereits aufgehoben.