Skip to main content

3.2.2. 通过 IC 卡认证的机密打印函数

本节将对控制打印的函数中，用于通过 IC 卡认证的机密打印功能的 API 函数进行说明。

通过 IC 卡认证的机密打印的支持打印机

在 SVF 中，各打印机机种分别支持以下通过 IC 卡认证的机密打印。

  • LIPS4（*1）

    • Anyplace Print for MEAP ADVANCE / Anyplace Print for MEAP / Anyplace Print for MEAP-Lite

    • Personal ListPrint for MEAP ADVANCE / Personal ListPrint for MEAP

  • ART4（*2）

    • PrintXchange 按需打印

    • 私密打印

    • ApeosWare Print Management

  • RPCS

    • IPSiO 个人认证工具包

    • imagio 个人认证工具包

    • 个人认证系统 AE

    • 个人认证系统 AE2

    • 简易私人收藏打印 AE2

  1. 在各公司打印机支持的机种或 Report Director Enterprise 中所添加的打印机的详细设置中，需将［外围设备的控制方法］的设置值设为 “CPCA-iR”、“CPCA-LBP” 或 “CPCA2”。

  2. 在各公司打印机支持的机种或 Report Director Enterprise 中所添加的打印机的详细设置中，需将［外围设备的控制方法］的设置值设为 “XPJL”。

参考

有关 SVF 打印机的［外围设备的控制方法］的设置，请参阅《SVF 报表输出产品管理指南》或《RDE 后台处理管理指南》。

通过 IC 卡认证的机密打印函数

在通过 IC 卡认证的机密打印中使用的 API 函数如下。

函数名

功能

VrComout("/{SECP}/")

使用通过 IC 卡认证的机密打印功能时指定。

VrComout("/{BOXN n}/")

指定 BOX 编号。

VrSetUserName

指定用户名。

VrSetDocName2

指定文档名。

VrComout("/{SECP}/")

功能

使用通过 IC 卡认证的机密打印功能时指定。

格式

  • Java/C#

    int instance.VrComout("/{SECP}/");

  • ASP/VB

    Function instance.VrComout("/{SECP}/") As Long

  • C

    int VrComout("/{SECP}/");

  • VB.NET

    Function instance.VrComout("/{SECP}/") As Integer

参数

无

返回值

  • 0

    成功

  • -40

    错误

    有关错误代码，请参阅《SVF 产品错误代码列表》的 “SVF 执行部产品”。

说明

使用通过 IC 卡认证的机密打印功能时执行。用户名和文档名需要另外使用 VrSetUserName 函数和 VrSetDocName2 函数指定。

函数使用顺序

在 VrSetPrinter 之后指定本函数。

svf.VrInit();
svf.VrSetPrinter("", "LIPS4");
svf.VrComout("/{SECP}/");
svf.VrComout("/{BOXN 3}/");
svf.VrSetUserName("user_name");
svf.VrSetDocName2("document_name");
svf.VrSetForm("sample.xml", 4);
：
svf.VrQuit();

VrComout("/{BOXN n}/")

功能

指定 BOX 编号。

格式

  • Java/C#

    int instance.VrComout("/{BOXN n}/");

  • ASP/VB

    Function instance.VrComout("/{BOXN n}/") As Long

  • C

    int VrComout("/{BOXN n}/");

  • VB.NET

    Function instance.VrComout("/{BOXN n}/") As Integer

参数

  • n

    BOX 编号

    指定 1～99 的整数。

返回值

  • 0

    成功

  • -40

    错误

    有关错误代码，请参阅《SVF 产品错误代码列表》的 “SVF 执行部产品”。

说明

使用打印机机种 LIPS4，并连接 “Personal ListPrint for MEAP”、“Personal ListPrint for MEAP ADVANCE” 时，指定存储 “Job” 的 BOX 编号。

在 VrComout("/{SECP}/") 函数之后调用该函数。

使用示例

将 BOX 编号指定为 3。

  • Java/C#

    svf.VrComout("/{BOXN 3}/");

  • ASP/VB

    svf.VrComout("/{BOXN 3}/")

  • C

    VrComout(svf, "/{BOXN 3}/");

  • VB.NET

    svf.VrComout("/{BOXN 3}/")

VrSetUserName

使用 VrComout("/{SECP}/") 函数时，如要使用共用函数 VrSetUserName，指定用户名。

有关 VrSetUserName 的详细内容，请参阅 “共用函数（3）” 的 “VrSetUserName”。

参考

执行了 VrComout("/{SECP}/") 时，或者在打印机的设置中将［机密打印功能］指定为 “使用” 时，使用的用户名根据是否指定 VrSetUserName 而有所不同。

  • 执行了 VrSetUserName 时

    使用 VrSetUserName 中指定的值。

  • 不执行 VrSetUserName 时

    使用登录用户名（Java 的系统属性 “user.name” 的值）。

VrSetDocName2

使用 VrComout("/{SECP}/") 函数时，如要使用共用函数 VrSetDocName2，指定文档名。

有关 VrSetDocName2 的详细内容，请参阅 “共用函数（2）” 的 “VrSetDocName2”。

参考

执行了 VrComout("/{SECP}/") 时，或者在打印机的设置中将［机密打印功能］指定为 “使用” 时，使用的用户名根据是否指定 VrSetDocName2 而有所不同。

  • 执行了 VrSetDocName2 时

    使用 VrSetDocName2 中指定的值。

  • 不执行 VrSetDocName2 时

    使用固定字符串 “SVF for Java Print”。

使用 RDE 实用工具时的限制事项和对应方法

使用 RDE 实用工具时，即使文档被指定了通过 IC 卡认证的机密打印，机密打印也可能无效。此时，对应方法如下。

  • 指定页进行打印时，如果不打印第 1 页，则无法在打印机端认证。

    使用 VrComout("/{DATR EnablePrintPageRange=1}/")，设置为不可指定部分页。

    有关 API 函数的详细内容，请参阅 “使用 Report Director Enterprise 时的函数” 的 “VrComout("/{DATR EnablePrintPageRange=n}/")”。

    另外，也可以通过在 RDE 环境设置的用户群组权限设置中取消勾选 “启用[指定页]”，来对应上述情况。

  • 可以向其他（无机密打印功能）打印机打印。

    使用 VrComout("/{DATR EnablePrinterKind=xxx}/")，限定可打印相应文档的打印机机种名。

    有关 API 函数的详细内容，请参阅 “使用 Report Director Enterprise 时的函数” 的 “VrComout("/{DATR EnablePrinterKind=xxx}/")”。

    另外，也可以通过在 RDE 环境设置的用户群组权限设置中限定可使用的打印机，来对应上述情况。

  • 可进行预览。

    使用 VrComout("/{DATR EnableView=1}/")，将相应文档设为不可预览。

    有关 API 函数的详细内容，请参阅 “使用 Report Director Enterprise 时的函数” 的 “VrComout("/{DATR EnableView=n}/")”。

    另外，也可以通过在 RDE 环境设置的用户群组权限设置中取消勾选 “启用[查看器]”，来对应上述情况。

有关 RDE 环境设置中的用户群组的权限设置，请参阅《RDE 后台处理管理指南》的 “管理员和用户的管理”。

: