Función ShutdownBlockReasonCreate (winuser.h)
Indica que el sistema no se puede apagar y establece una cadena de motivo que se mostrará al usuario si se inicia el apagado del sistema.
Sintaxis
BOOL ShutdownBlockReasonCreate(
[in] HWND hWnd,
[in] LPCWSTR pwszReason
);
Parámetros
[in] hWnd
Identificador de la ventana principal de la aplicación.
[in] pwszReason
Motivo por el que la aplicación debe bloquear el apagado del sistema. Esta cadena se truncará con fines de presentación después de MAX_STR_BLOCKREASON caracteres.
Valor devuelto
Si la llamada se realiza correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la llamada, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Esta función solo se puede llamar desde el subproceso que creó la ventana especificada por el parámetro hWnd . De lo contrario, se produce un error en la función y se ERROR_ACCESS_DENIED el último código de error.
Las aplicaciones deben llamar a esta función a medida que inician una operación que no se puede interrumpir, como grabar un CD o DVD. Cuando se haya completado la operación, llame a la función ShutdownBlockReasonDestroy para indicar que el sistema se puede apagar.
Dado que los usuarios suelen tener prisa al apagar el sistema, pueden dedicar solo unos segundos a examinar los motivos de apagado que muestra el sistema. Por lo tanto, es importante que las cadenas de motivo sean cortas y claras. Por ejemplo, "Una grabación de CD está en curso" es mejor que "Esta aplicación bloquea el apagado del sistema porque hay una grabación de CD en curso. No se apague".
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-misc-l1-1-0 (introducido en Windows 8) |