GetAPIScopeReportJSON

진단, 콘텐츠 스트림 검사, 문서 편집

설명

API 범위 위반, 현재 활성 런타임 범위 및 선택적 선택 페이지 콘텐츠 검증에 대한 결정적 JSON 보고서를 반환합니다

구문

Delphi

Function TPDFlib.GetAPIScopeReportJSON(
  Options: Integer= PDF_API_SCOPE_INCLUDE_CONTENT): WideString;

ActiveX

Function PDFlib::GetAPIScopeReportJSON(Options As Long) As String

DLL

const wchar_t* DLGetAPIScopeReportJSON(int InstanceID, int Options);
const char* DLGetAPIScopeReportJSONA(int InstanceID, int Options);

매개변수

Options0은 런타임 상태와 유지된 위반을 보고하며, PDF_API_SCOPE_INCLUDE_CONTENT는 선택한 페이지의 모든 콘텐츠 레이어도 구문 분석합니다

반환 값

전체 valid 및 balanced 플래그, 선택 문서와 페이지, currentScope, 활성 컨테이너 및 깊이 필드, 전체 및 유지 위반 수, 순서가 지정된 런타임 이벤트 및 content 검증 객체를 포함한 JSON을 반환합니다

각 런타임 이벤트에는 단조 증가 시퀀스, 문서, 페이지, API 이름, 안정적 코드, 예상 및 실제 범위, 진단 메시지가 포함됨

콘텐츠 검증은 일치하지 않거나 닫히지 않은 q/Q, BT/ET, 표시 콘텐츠 및 경로 시퀀스를 토큰 위치와 함께 보고함

빈 문자열을 반환하고 LastErrorCode를 117로 설정하는 경우는 Options에 지원되지 않는 비트가 포함되었을 때입니다

비고

런타임 추적은 성공적인 전이에서 상수 시간 오버헤드만 발생시키며 일반 그리기 호출에서는 할당 없이 최근 위반 256개를 유지합니다

잘못 추적된 전이는 즉시 0을 반환하고 LastErrorCode 117을 설정하여 경로의 조용한 손실, 그래픽 상태 언더플로, 일치하지 않는 마크 콘텐츠 닫기 또는 열린 범위가 있는 상태의 컨텍스트 변경을 방지합니다

이 메서드를 호출해도 보존된 위반 사항이 지워지거나 활성 범위가 변경되지 않습니다. 보고서를 사용한 후 ClearAPIScopeReport를 사용합니다

참고 항목

ClearAPIScopeReport, GetAPIScopeReportJSONA, TraceGraphicsStates