ShutdownBlockReasonCreate-Funktion (winuser.h)

  • Artikel

Gibt an, dass das System nicht heruntergefahren werden kann, und legt eine Grundzeichenfolge fest, die dem Benutzer angezeigt werden soll, wenn das Herunterfahren des Systems initiiert wird.

Syntax

BOOL ShutdownBlockReasonCreate(
  [in] HWND    hWnd,
  [in] LPCWSTR pwszReason
);

Parameter

[in] hWnd

Ein Handle für das Standard Fenster der Anwendung.

[in] pwszReason

Der Grund, warum die Anwendung das Herunterfahren des Systems blockieren muss. Diese Zeichenfolge wird zu Anzeigezwecken nach MAX_STR_BLOCKREASON Zeichen abgeschnitten.

Rückgabewert

Wenn der Aufruf erfolgreich ist, ist der Rückgabewert ungleich null.

Wenn der Aufruf fehlschlägt, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion kann nur über den Thread aufgerufen werden, der das durch den hWnd-Parameter angegebene Fenster erstellt hat. Andernfalls schlägt die Funktion fehl, und der letzte Fehlercode wird ERROR_ACCESS_DENIED.

Anwendungen sollten diese Funktion aufrufen, wenn sie einen Vorgang starten, der nicht unterbrochen werden kann, z. B. das Brennen einer CD oder DVD. Wenn der Vorgang abgeschlossen ist, rufen Sie die ShutdownBlockReasonDestroy-Funktion auf, um anzugeben, dass das System heruntergefahren werden kann.

Da Benutzer beim Herunterfahren des Systems in der Regel eilig sind, verbringen sie möglicherweise nur einige Sekunden damit, die Gründe für das Herunterfahren zu untersuchen, die vom System angezeigt werden. Daher ist es wichtig, dass Ihre Ursachenzeichenfolgen kurz und klar sind. Beispiel: "Ein CD-Brennvorgang wird ausgeführt" ist besser als "Diese Anwendung blockiert das Herunterfahren des Systems, da ein CD-Brennen ausgeführt wird. Nicht herunterfahren."

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-misc-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

ShutdownBlockReasonDestroy

Herunterfahren