IInkAnalyzer：：Abort 方法

取消当前分析操作。

语法

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

ppAbortedRegion [out]: 指向 IAnalysisRegion 的指针，该指针表示脏区域， (请参阅当前分析操作的 IInkAnalyzer：：GetDirtyRegion 方法) 。

有关返回值的说明，请参阅类和接口 - 墨迹分析。

如果不再需要使用对象，请调用 iUnknown：：Release on ppAbortedRegion 。

此方法取消当前分析操作。

当 ppAbortedRegion 为 NULL 时，此方法将正常执行中止，因为这表示调用方对返回值不感兴趣。

IInkAnalyzer：：Abort 方法 将当前分析操作的 _IAnalysisEvents：：Results 和 _IAnalysisEvents：：Activity 事件静音。

IInkAnalyzer：：Abort 方法 异步运行，直到取消当前后台分析操作。由于取消过程是异步的，因此应用程序可以在取消当前分析操作时执行其他任务。

如果没有正在进行的分析操作，此方法将返回空的分析区域。

如果正在进行一个分析操作，此方法将取消该操作。

如果同步和异步分析操作都在进行中，此方法将取消同步操作。

如果针对同一分析操作多次调用此方法，则第一次调用将返回操作的脏区域，后续调用将返回一个空区域。

如果应用程序维护自己的数据结构，该结构与 IInkAnalyzer 的数据结构同步，则调用 IInkAnalyzer：：Abort 方法 可能会使文档留下部分结果。若要避免这种情况，请勿在 IInkAnalyzer 收到 _IAnalysisProxyEvents：：InkAnalyzerStateChanging 事件与 IInkAnalyzer 收到 _IAnalysisEvents：：IntermediateResults 或 _IAnalysisEvents：：Results 事件之间调用 IInkAnalyzer：：Abort 方法。

有关将应用程序数据与墨迹分析器同步的详细信息，请参阅使用墨迹分析的数据代理。

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	IACom.h (还需要 IACom_i.c)
DLL	IACom.dll