IInkAnalyzer::Abort, metoda

Anuluje bieżącą operację analizy.

Składnia

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

Parametry

ppAbortedRegion [out]

Wskaźnik do regionu IAnalysisRegion , który reprezentuje zanieczyszczony region (zobacz IInkAnalyzer::GetDirtyRegion Method) bieżącej operacji analizy.

Wartość zwracana

Aby uzyskać opis zwracanych wartości, zobacz Klasy i interfejsy — analiza pisma odk.

Uwagi

Wywołaj metodę IUnknown::Release w regionie ppAbortedRegion , gdy nie musisz już używać obiektu .

Ta metoda anuluje bieżącą operację analizy.

Jeśli parametr ppAbortedRegion ma wartość NULL, ta metoda wykonuje przerwanie w normalny sposób, ponieważ wskazuje to, że obiekt wywołujący nie ma zainteresowania wartością zwracaną.

Metoda IInkAnalyzer::Abort wycisza zdarzenia _IAnalysisEvents::Results i _IAnalysisEvents::Activity dla bieżącej operacji analizy.

Metoda IInkAnalyzer::Abort jest uruchamiana asynchronicznie do momentu anulowania bieżącej operacji analizy w tle. Ponieważ proces anulowania jest asynchroniczny, aplikacja może wykonywać inne zadania podczas anulowania bieżących operacji analizy.

Jeśli żadne operacje analizy nie są w toku, ta metoda zwraca pusty region analizy.

Jeśli jedna operacja analizy jest w toku, ta metoda anuluje operację.

Jeśli w toku są zarówno operacje synchroniczne, jak i asynchroniczne, ta metoda anuluje operację synchroniczną.

Jeśli ta metoda jest wywoływana więcej niż raz dla tej samej operacji analizy, pierwsze wywołanie zwraca zanieczyszczony region dla operacji, a kolejne wywołania zwracają pusty region.

Jeśli aplikacja zachowuje własną strukturę danych zsynchronizowaną z elementem IInkAnalyzer, wywołanie metody IInkAnalyzer::Abort może pozostawić dokument z częściowymi wynikami. Aby tego uniknąć, nie należy wywoływać metody IInkAnalyzer::Abort między czasem odebrania zdarzenia _IAnalysisProxyEvents::InkAnalyzerStateChanging i czasu odebraniazdarzenia _IAnalysisEvents::IntermediateResults lub _IAnalysisEvents::Results.

Aby uzyskać więcej informacji na temat synchronizowania danych aplikacji za pomocą analizatora pisma odręcznego, zobacz Serwer proxy danych z analizą pisma odręcznego.

Wymagania

Zobacz także

IInkAnalyzer

IInkAnalyzer::Analyze — Metoda

IInkAnalyzer::BackgroundAnalyze — Metoda

IInkAnalyzer::GetDirtyRegion — Metoda

IInkAnalyzer::SetDirtyRegion — Metoda

dokument referencyjny analizy atramentu