Methode IInkAnalyzer::Abort

Hiermee wordt de huidige analysebewerking geannuleerd.

Syntaxis

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

Parameterwaarden

ppAbortedRegion [out]

Een aanwijzer naar een IAnalysisRegion die de vuile regio vertegenwoordigt (zie IInkAnalyzer::GetDirtyRegion Method) van de huidige analysebewerking.

Retourwaarde

Zie Klassen en interfaces - Inktanalyse voor een beschrijving van de retourwaarden.

Opmerkingen

Roep IUnknown::Release op ppAbortedRegion aan wanneer u het object niet meer hoeft te gebruiken.

Met deze methode wordt de huidige analysebewerking geannuleerd.

Wanneer ppAbortedRegionNULL is, wordt met deze methode de abort als normaal uitgevoerd, omdat dit aangeeft dat de aanroeper geen belang heeft in de retourwaarde.

De methode IInkAnalyzer::Abort geeft de _IAnalysisEvents::Resultaten en _IAnalysisEvents::Activiteitsgebeurtenissen voor de huidige analysebewerking stil.

Methode IInkAnalyzer::Abort wordt asynchroon uitgevoerd totdat de huidige achtergrondanalysebewerking wordt geannuleerd. Omdat het annuleringsproces asynchroon is, kan de toepassing andere taken uitvoeren terwijl de huidige analysebewerkingen worden geannuleerd.

Als er geen analysebewerkingen worden uitgevoerd, retourneert deze methode een leeg analysegebied.

Als er één analysebewerking wordt uitgevoerd, annuleert deze methode de bewerking.

Als zowel synchrone als asynchrone analysebewerkingen worden uitgevoerd, annuleert deze methode de synchrone bewerking.

Als deze methode meer dan één keer wordt aangeroepen voor dezelfde analysebewerking, retourneert de eerste aanroep de vuile regio voor de bewerking en retourneren de volgende aanroepen een lege regio.

Als uw toepassing een eigen gegevensstructuur onderhoudt die wordt gesynchroniseerd met die van de IInkAnalyzer, kan het aanroepen van de methode IInkAnalyzer::Abort uw document met gedeeltelijke resultaten verlaten. Om dit te voorkomen, roept u IInkAnalyzer::Abort-methode niet aan tussen het tijdstip waarop de IInkAnalyzer de gebeurtenis _IAnalysisProxyEvents::InkAnalyzerStateChanging ontvangt en de tijd dat de IInkAnalyzer de gebeurtenis _IAnalysisEvents::IntermediateResults of _IAnalysisEvents::Results ontvangt.

Zie Gegevensproxy met Inktanalyse voor meer informatie over het synchroniseren van uw toepassingsgegevens met de inktanalyse.

Behoeften

Zie ook

IInkAnalyzer-

Methode IInkAnalyzer::Analyze

Methode IInkAnalyzer::BackgroundAnalyze

Methode IInkAnalyzer::GetDirtyRegion

Methode IInkAnalyzer::SetDirtyRegion

Inktanalyse Referentie