IInkAnalyzer::Abort 메서드

현재 분석 작업을 취소합니다.

구문

HRESULT Abort(
  [out] IAnalysisRegion **ppAbortedRegion
);

ppAbortedRegion [out]: 현재 분석 작업의 더티 지역을 나타내는 IAnalysisRegion(IInkAnalyzer::GetDirtyRegion 메서드 참조)에 대한 포인터입니다.

개체를 더 이상 사용할 필요가 없는 경우 ppAbortedRegion에서 IUnknown::Release를 호출합니다.

이 메서드는 현재 분석 작업을 취소합니다.

ppAbortedRegion이 NULL이면 호출자가 반환 값에 관심이 없음을 나타내기 때문에 이 메서드는 정상적으로 중단을 수행합니다.

IInkAnalyzer::Abort 메서드 는 현재 분석 작업에 대한 _IAnalysisEvents::Results 및 _IAnalysisEvents::Activity 이벤트를 침묵합니다.

IInkAnalyzer::Abort 메서드 는 현재 백그라운드 분석 작업이 취소될 때까지 비동기적으로 실행됩니다. 취소 프로세스는 비동기적이므로 현재 분석 opertions가 취소되는 동안 애플리케이션에서 다른 작업을 수행할 수 있습니다.

분석 작업이 진행 중이 아니면 이 메서드는 빈 분석 영역을 반환합니다.

하나의 분석 작업이 진행 중인 경우 이 메서드는 작업을 취소합니다.

동기 및 비동기 분석 작업이 모두 진행 중인 경우 이 메서드는 동기 작업을 취소합니다.

이 메서드가 동일한 분석 작업에 대해 두 번 이상 호출되면 첫 번째 호출은 작업에 대한 더티 지역을 반환하고 후속 호출은 빈 지역을 반환합니다.

애플리케이션이 IInkAnalyzer의 데이터 구조와 동기화되는 자체 데이터 구조를 유지 관리하는 경우 IInkAnalyzer::Abort 메서드 를 호출하면 문서가 부분적인 결과로 남을 수 있습니다. 이를 방지하려면 IInkAnalyzer가 _IAnalysisProxyEvents::InkAnalyzerStateChanging 이벤트를 수신하는 시간과 IInkAnalyzer가 _IAnalysisEvents::IntermediateResults 또는 _IAnalysisEvents::Results 이벤트를 수신하는 시간 사이에 IInkAnalyzer::Abort 메서드를 호출하지 마세요.

애플리케이션 데이터를 잉크 분석기와 동기화하는 방법에 대한 자세한 내용은 잉크 분석을 사용하여 데이터 프록시를 참조하세요.