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

Consulte también

ShutdownBlockReasonDestroy

Cerrando