ShutdownBlockReasonCreate-Funktion (winuser.h)
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) |