WerRegisterFile 함수(werapi.h)

WER(Windows 오류 보고)이 오류 보고서를 만들 때 수집할 파일을 등록합니다.

구문

HRESULT WerRegisterFile(
  [in] PCWSTR                 pwzFile,
  [in] WER_REGISTER_FILE_TYPE regFileType,
  [in] DWORD                  dwFlags
);

매개 변수

[in] pwzFile

파일의 전체 경로입니다. 이 경로의 최대 길이는 MAX_PATH 문자입니다.

[in] regFileType

파일 형식입니다. 이 매개 변수는 WER_REGISTER_FILE_TYPE 열거형 형식의 다음 값 중 하나일 수 있습니다.

값	의미
WerRegFileTypeMax
3	WER_REGISTER_FILE_TYPE 열거형 형식의 최대값입니다.
WerRegFileTypeOther
2	다른 파일 형식입니다.
WerRegFileTypeUserDocument
1	이벤트 당시 애플리케이션에서 사용 중인 문서입니다. 이 문서는 Watson 서버에서 요청하는 경우에만 수집됩니다.

[in] dwFlags

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
WER_FILE_ANONYMOUS_DATA	파일에는 사용자를 식별하거나 연락하는 데 사용할 수 있는 개인 정보가 포함되어 있지 않습니다.
WER_FILE_DELETE_WHEN_DONE	파일이 보고서에 추가된 후 자동으로 삭제됩니다.

반환 값

이 함수는 성공 시 S_OK 반환하거나 다음 오류 코드를 포함하여 실패 시 오류 코드를 반환합니다.

반환 코드	설명
WER_E_INVALID_STATE	프로세스 상태가 잘못되었습니다. 예를 들어 프로세스는 애플리케이션 복구 모드에 있습니다.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	등록된 메모리 블록 및 파일 수가 제한을 초과합니다.

설명

등록된 파일은 서버에서 추가 데이터를 요청하는 경우에만 보고서에 추가됩니다.

크래시 및 비 응답의 경우 운영 체제는 자동으로 오류 보고를 제공합니다(애플리케이션에서 오류 보고 코드를 제공할 필요가 없음). 이 함수를 사용하여 파일을 등록하는 경우 운영 체제는 크래시 또는 비응답 시 생성된 오류 보고서에 파일을 추가합니다(이 파일은 운영 체제에서 이미 수집한 파일 외에 추가됨).

제네릭 이벤트 보고를 위해 애플리케이션은 WerReportAddFile 함수를 대신 사용해야 합니다. 또는 WER_SUBMIT_ADD_REGISTERED_DATA 플래그를 사용하여 WerReportSubmit 함수를 호출하면 WerRegisterFile 함수가 추가한 파일이 포함됩니다.

목록에서 파일을 제거하려면 WerUnregisterFile 함수를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	werapi.h
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

WerUnregisterFile, Windows 오류 보고