跳转到主要内容
此函数用于取消初始化 ABBYY FineReader Engine。对于通过 InitializeEngine 函数获取的 Engine 对象，必须调用此函数进行取消初始化。在取消初始化之前，你必须释放对 FineReader Engine 对象的所有引用。

​
语法

​
C++

HRESULT __stdcall DeinitializeEngine();

​
C#

int DeinitializeEngine();

​
Visual Basic .NET

Private Declare Function DeinitializeEngine Lib "FREngine.dll" () As Integer

​
返回值

如果并非所有对象都已被释放，此函数将返回 E_FAIL。在这种情况下，您可以使用 IEngine::StartLogging 方法获取未释放对象的列表。此函数还可能返回 ABBYY FineReader Engine 函数的标准返回值。

​
备注

不要在其他动态库的入口点，也不要在动态库中实现的静态对象和全局对象的构造函数及析构函数中初始化或取消初始化 ABBYY FineReader Engine，因为这些函数会在动态库入口点被调用。
用户应在其他位置初始化和取消初始化 ABBYY FineReader Engine。例如，在可执行模块的 main 或 WinMain 函数中。
在 Windows 中，之所以有此限制，是因为 Win32 的 LoadLibrary 和 FreeLibrary 函数不是可重入的。

​
示例

IEngine* FineReaderEngine = 0;
HMODULE EngineLibraryHandle = 0;
static HRESULT deinitializeEngine()
{
 // 释放 Engine 对象
 if( FineReaderEngine != 0 ) {
  FineReaderEngine->Release();
  FineReaderEngine = 0;
 }
 // 调用 DeinitializeEngine
 typedef HRESULT (STDAPICALLTYPE* DeinitializeEngineFunc)();
 DeinitializeEngineFunc pDeinitializeEngine =
  (DeinitializeEngineFunc)GetProcAddress( EngineLibraryHandle, "DeinitializeEngine" );
 if( pDeinitializeEngine == 0 || FAILED( pDeinitializeEngine() ) ) {
  setLastErrorInfo( L"无法卸载 FineReader Engine。" );
  return E_UNEXPECTED;
 }
 return S_OK;
}

public class EngineLoader : IDisposable
{
    // 卸载 FineReader Engine
    public void Dispose()
    {
        if (engine == null)
        {
            // 尚未加载 Engine
            return;
        }
        engine = null;
        // 在调用 FreeLibrary 之前删除所有对象
        GC.Collect();
        GC.WaitForPendingFinalizers();
        GC.Collect();
        int hresult = deinitializeEngine();
 
        hresult = dllCanUnloadNow();
        if (hresult == 0)
        {
            FreeLibrary(dllHandle);
        }
        dllHandle = IntPtr.Zero;
        initializeEngine = null;
        deinitializeEngine = null;
        dllCanUnloadNow = null;
        // 清理后抛出异常
        Marshal.ThrowExceptionForHR(hresult);
    }
    // Kernel32.dll 函数
    [DllImport("kernel32.dll")]
    private static extern IntPtr LoadLibraryEx(string dllToLoad, IntPtr reserved, uint flags);
    private const uint LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008;
    [DllImport("kernel32.dll")]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string procedureName);
    [DllImport("kernel32.dll")]
    private static extern bool FreeLibrary(IntPtr hModule);
    // FREngine.dll 函数
    [UnmanagedFunctionPointer(CallingConvention.StdCall, CharSet = CharSet.Unicode)]
    private delegate int InitializeEngine( string customerProjectId, string LicensePath, string LicensePassword, , , , ref FREngine.IEngine engine);
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DeinitializeEngine();
    [UnmanagedFunctionPointer(CallingConvention.StdCall)]
    private delegate int DllCanUnloadNow();
    // 私有变量
    private FREngine.IEngine engine = null;
    // FREngine.dll 的 Handle
    private IntPtr dllHandle = IntPtr.Zero;
    private InitializeEngine initializeEngine = null;
    private DeinitializeEngine deinitializeEngine = null;
    private DllCanUnloadNow dllCanUnloadNow = null;
}
除 Windows EnginesPool 示例外，此函数用于所有代码示例。

​
另请参阅

InitializeEngine 加载 Engine 对象的不同方式