WerRegisterCustomMetadata 함수(werapi.h)

WER(Windows 오류 보고) 오류 보고서에 대해 수집할 앱별 메타데이터(키/값 문자열 형식)를 등록합니다.

구문

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

key

등록되는 메타데이터 요소에 대한 "키" 문자열입니다.

value

등록할 메타데이터 요소의 값 문자열입니다.

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

반환 코드	설명
E_INVALIDARG	문자열은 NULL이거나 키 길이가 64자보다 크거나 잘못된 xml 요소 이름이거나 값 길이가 128자보다 크거나 ASCII 인쇄 가능 문자가 아닌 포함된 문자입니다.
E_OUTOFMEMORY	WER이 데이터에 충분한 힙을 할당할 수 없습니다.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	등록된 최대 항목 수(WER_MAX_REGISTERED_ENTRIES) 또는 등록된 메타데이터(WER_MAX_REGISTERED_METADATA)의 최대 양에 도달했습니다.
WER_E_INVALID_STATE	프로세스 상태가 잘못되었습니다. 예를 들어 프로세스는 애플리케이션 복구 모드에 있습니다.

이 API를 사용하면 앱 메타데이터를 프로세스에 해당하는 크래시 보고서와 연결하여 앱이 자체 앱 수준 원격 분석을 WER(시스템 수준 원격 분석)과 통합할 수 있습니다.