Foxit PDF Conversion SDK
PDFConversionSDK::Library类 参考

静态 Public 成员函数

static GetVersion ()
 获取当前 Foxit PDF Conversion SDK 库的版本。 更多...
 
static Initialize (sn, key)
 使用有效的许可证信息初始化 Foxit PDF Conversion SDK 库。 更多...
 
static Reinitialize ()
 重新初始化 Foxit PDF Conversion SDK 库。 更多...
 
static Release ()
 释放 Foxit PDF Conversion SDK 库分配的所有资源。 更多...
 
static SetConvertCheckCallback (convert_check_callback)
 设置回调对象以检查 PDF 到 Office 转换条件。 更多...
 

详细描述

此类表示库管理。 它包含初始化/重新初始化/释放 Foxit PDF Conversion SDK 库的函数,还包含全局使用的函数。
任何应用程序在调用任何其他 Foxit PDF Conversion SDK 函数之前,应通过函数 Library.Initialize 加载 Foxit PDF Conversion SDK。当不再需要使用 Foxit PDF Conversion SDK 时,请调用 函数 Library.Release
Foxit PDF Conversion SDK 中的函数在发生某些错误时可能会抛出异常。用户可以捕获这些异常,并 检查以 PDFConversionSDK.e_ErrFile 开头的错误代码值,以了解更多关于发生了什么错误。

注解
在应用程序的生命周期中,Library.InitializeLibrary.Release 应 成对调用,并且只能调用一次。在应用程序的生命周期中调用 Library.Release 后,Foxit PDF Conversion SDK 就不能再次初始化了。 在调用 Library.Release 之前,如果用户想重新初始化 Foxit PDF Conversion SDK,请参考 函数 Library.Reinitialize

成员函数说明

◆ GetVersion()

static PDFConversionSDK::Library::GetVersion ( )
static

获取当前 Foxit PDF Conversion SDK 库的版本。

返回
版本字符串。

◆ Initialize()

static PDFConversionSDK::Library::Initialize ( sn  ,
key   
)
static

使用有效的许可证信息初始化 Foxit PDF Conversion SDK 库。

在应用程序的生命周期中,此函数只能调用一次, 并且应在 Foxit PDF Conversion SDK 中的任何其他函数之前首先调用。
一旦调用了函数 Library.Release,在应用程序的生命周期中 Foxit PDF Conversion SDK 库就不能再次初始化了。

参数
[in]snSN 信息字符串,可以从密钥文件 "gsdk_sn.txt" 或 "rdk_sn.txt" 中的 "SN=" 部分获取。
[in]key密钥信息字符串,可以从密钥文件 "gsdk_key.txt" 或 "rdk_key.txt" 中的 "Sign=" 部分获取。
返回
PDFConversionSDK.e_ErrSuccess 表示成功。
PDFConversionSDK.e_ErrInvalidLicense 表示输入的许可证信息无效。
PDFConversionSDK.e_ErrParam 表示参数 snkey 是空字符串。
有关错误代码值的更多信息,请参考从 PDFConversionSDK.e_ErrSuccess 开始的值。

◆ Reinitialize()

static PDFConversionSDK::Library::Reinitialize ( )
static

重新初始化 Foxit PDF Conversion SDK 库。

当用户遇到内存不足错误或用户想在调用函数 Library.Release 之前 重新初始化 Foxit PDF Conversion SDK 库时,用户可以调用此函数来重新初始化 Foxit PDF Conversion SDK 库。
一旦调用了函数 Library.Release,在应用程序的生命周期中 Foxit PDF Conversion SDK 库就不能再次初始化了。

返回
PDFConversionSDK.e_ErrSuccess 表示成功。 有关错误代码值的更多信息,请参考从 PDFConversionSDK.e_ErrSuccess 开始的值。

◆ Release()

static PDFConversionSDK::Library::Release ( )
static

释放 Foxit PDF Conversion SDK 库分配的所有资源。

用户应调用此函数来释放库分配的所有内存块。
一旦调用此函数,在应用程序的生命周期中 Foxit PDF Conversion SDK 库就不能再次初始化了。

返回
无。

◆ SetConvertCheckCallback()

static PDFConversionSDK::Library::SetConvertCheckCallback ( convert_check_callback  )
static

设置回调对象以检查 PDF 到 Office 转换条件。

此方法允许您指定自定义转换检查回调, 该回调将被调用以评估是否应根据用户定义的逻辑继续从 PDF 到 Office 的转换, 当转换 PDF 文档所需的权限不满足时。

参数
[in]convert_check_callback基于回调类 ConvertCheckCallback 实现的自定义转换检查回调。 如果为 NULL,将删除自定义转换检查回调,并使用默认转换检查。
返回
true 表示成功,false 表示失败。