ShutdownBlockReasonCreate 함수(winuser.h)

시스템을 종료할 수 없음을 나타내고 시스템 종료가 시작된 경우 사용자에게 표시할 이유 문자열을 설정합니다.

구문

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

매개 변수

[in] hWnd

애플리케이션의 기본 창에 대한 핸들입니다.

[in] pwszReason

애플리케이션이 시스템 종료를 차단해야 하는 이유입니다. 이 문자열은 MAX_STR_BLOCKREASON 문자 후에 표시 목적으로 잘립니다.

반환 값

호출이 성공하면 반환 값은 0이 아닌 값입니다.

호출이 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 hWnd 매개 변수로 지정된 창을 만든 스레드에서만 호출할 수 있습니다. 그렇지 않으면 함수가 실패하고 마지막 오류 코드가 ERROR_ACCESS_DENIED.

애플리케이션은 CD 또는 DVD 레코딩과 같이 중단될 수 없는 작업을 시작할 때 이 함수를 호출해야 합니다. 작업이 완료되면 ShutdownBlockReasonDestroy 함수를 호출하여 시스템을 종료할 수 있음을 나타냅니다.

사용자는 일반적으로 시스템을 종료할 때 서두르기 때문에 시스템에서 표시하는 종료 이유를 살펴보는 데 몇 초밖에 소요되지 않을 수 있습니다. 따라서 이유 문자열이 짧고 명확해야 합니다. 예를 들어 "CD 번이 진행 중입니다."가 "CD 번이 진행 중이므로 이 애플리케이션이 시스템 종료를 차단하는 것보다 낫습니다. 종료하지 마세요."

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-misc-l1-1-0(Windows 8 도입)

추가 정보

ShutdownBlockReasonDestroy

종료