ShutdownBlockReasonCreate Function

ShutdownBlockReasonCreate Function
Indicates that the system cannot be shut down and sets a reason string to be displayed to the user if system shutdown is initiated.shutdown을 초기화할 때 시스템이 꺼지지 않고 사용자에게 보여줄 이유를 설정합니다

Syntax

C++

												BOOL WINAPI ShutdownBlockReasonCreate(
  __in  HWND hWnd,
  __in  LPCWSTR pwszReason
);
										

Parameters

hWnd [in]
A handle to the main window of the application.메인 창을 가리키는 핸들
pwszReason [in]
The reason the application must block system shutdown. This string will be truncated for display purposes after MAX_STR_BLOCKREASON characters.

Return Value

If the call succeeds, the return value is nonzero.
If the call fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function can only be called from the thread that created the window specified by the hWnd parameter. Otherwise, the function fails and the last error code is ERROR_ACCESS_DENIED.이 함수는 창의 루틴만 호출되고 hwnd 파라미터를 전달할 수 있습니다. 그렇지 않으면 이 함수는 실패하고 ERROR_ACCESS_DNIED 오류 Applications should call this function as they begin an operation that cannot be interrupted, such as burning a CD or DVD.When the operation has completed, call the ShutdownBlockReasonDestroy function to indicate that the system can be shut down.프로그램이 CD or DVD를 가져오는 것과 같이 중단할 수 없는 작업을 시작하면 이 함수를 호출할 수 있습니다. 작업이 끝났을 때 ShutDownBlockReasonDestroy () 함수를 호출하면 시스템이 꺼질 수 있음을 나타냅니다.
Because users are typically in a hurry when shutting down the system, they may spend only a few seconds looking at the shutdown reasons that are displayed by the system. Therefore, it is important that your reason strings are short and clear. For example "A CD burn is in progress."is better than "This application is blocking system shutdown because a CD burn is in progress. Do not shut down."사용자들은 보통 시스템을 끄려고 서두르기 때문이다.그들은 시스템이 꺼진 이유를 몇 초 동안 볼 수도 있다.그래서 당신의'꺼진 이유'는 간단명료해야 합니다.'CD 뽑기 작업 중...''이 프로그램이 시스템의 전원을 끄는 것을 막았는데, CD를 꺼내는 것이 처리 중이기 때문에, 닫을 수 없기 때문에'보다 훨씬 낫다.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Header
Winuser.h (include Windows.h)
Library
User32.lib
DLL
User32.dll
Vista & Win2008 이후 버전에서만 지원