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 도입) |