WerReportHang 함수(errorrep.h)
지정된 창에서 "응답 없음" 보고를 시작합니다.
구문
HRESULT WerReportHang(
[in] HWND hwndHungApp,
[in, optional] PCWSTR pwzHungApplicationName
);
매개 변수
[in] hwndHungApp
응답하지 않는 창에 대한 핸들입니다.
[in, optional] pwzHungApplicationName
중단 보고 UI에 표시할 응답하지 않는 애플리케이션의 이름입니다. 이름은 NULL 종결자를 포함하여 128자로 제한됩니다. NULL인 경우 WER은 대상 이미지 리소스에서 이름을 가져옵니다. 이미지에서 이름을 가져올 수 없는 경우 이미지 이름이 사용됩니다.
반환 값
함수가 오류 발생 시 보고 또는 오류 코드를 시작할 수 있었는지 S_OK 반환합니다. S_OK 반드시 "응답 없음" 보고가 성공적으로 완료되었다는 의미는 아니며, 시작되었음을 의미합니다.
설명
주의 애플리케이션은 최상위 창에서 응답을 보고하지 않는 데 이 API를 사용하면 안 됩니다. 응답 없음 검색 및 보고는 기본적으로 Windows XP 이상에서 모든 최상위 창에서 사용할 수 있습니다. 이 함수는 자식 창에서 응답을 보고하지 않는 경우에만 사용해야 합니다. 일반적으로 최상위 창과 해당 자식 창이 서로 다른 프로세스에 의해 소유되고 자식 창에서 비응답이 검색되는 경우에만 이 함수를 사용합니다.
이 함수는 비동기입니다. 응답 없음 보고가 완료되기를 기다리지 않습니다. 응답 없음 보고가 시작된 후 취소할 수 있는 방법은 없습니다.
이 함수를 사용하는 경우 다음 요구 사항을 준수하는 것이 중요합니다.
- 자식 창이 별도의 프로세스에 의해 생성되었는지 확인합니다. 응답 없음 보고가 완료되면 창을 만든 프로세스가 종료됩니다.
- 자식 창에서 응답하지 않는 시각적 단서를 제공합니다. 응답 없음 보고는 자식 창을 흐리게 표시하지 않고 보고 대화 상자만 표시합니다.
- 사용자가 이 함수를 호출하기 전에 응답하지 않는 자식 창을 종료하려고 하는지 확인합니다.
- 응답 없음 보고 UI가 응답하지 않는 창 앞에 표시되도록 하려면 애플리케이션은 최상위 창의 프로세스에서 AllowSetForegroundWindow (프로세스 식별자에 대한 ASFW_ANY 전달) 함수를 호출해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | WINDOWS Vista SP1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | errorrep.h |
| 라이브러리 | Faultrep.lib |
| DLL | Faultrep.dll |