第十四章 从 Windows 客户端控制 IRIS

IRIS 为 Windows 客户端程序提供了一种机制来控制 IRIS 配置并启动 IRIS 进程。这使能够交付使用正确配置信息自动启动 IRIS 进程的应用程序，而无需标准 IRIS 工具。这些工具允许：

• 查找给定配置名称的 IRIS 目录、路径和服务名称。
• 获取 IRIS 系统的状态。
• 直接或通过 IRIS 控制服务控制 IRIS 配置，具体取决于运行的 Windows 版本
• 使用适当的设置启动 IRIS 进程。

可以通过动态加载 irisctl.dll 并使用其函数来执行这些操作。

IRISctlGetDirs

查找配置、二进制和管理器目录路径，以及给定配置名称的服务名称。

Syntax

IRISctlGetDirs(char *config, IRISCTL_DIR_INFO *dirinfo)

• config - 所需配置的名称。
• dirinfo - 指向将存储目录信息的 C 结构的指针。

Return Values

出错时返回 (char *0)。

IRISctlConfigStatus

返回 IRIS 配置的状态。

Syntax

IRISctlConfigStatus(char* config)

• config - 所需配置的名称

Return Values

返回 0 到 4 之间的值，如下所示：

• 0 配置已启动并正在运行。
• 1 配置正在启动或停止。
• 2 配置启动或关闭中止。
• 3 配置已关闭。
• 4 错误

IRISctlControl

通过 Windows NT 上的 IRIS 控制服务或直接在 Windows 95/98 上控制 IRIS 配置。

Syntax

IRISctlControl(char *command, char *config)

• command - 使用以下命令之一：
  • start — 启动配置
  • stop — 正常关闭配置
  • stopnoshut — 关闭配置而不运行用户提供的关闭例程
  • force — 强制关闭配置；相当于 UNIX® 系统上的 irisforce
  • stopstart — 正常关闭配置并立即重新启动它

Return Values

• IRISCTL_SUCCESS - 操作成功
• IRISCTL_ERROR - 一般错误
• IRISCTL_INVALID_COMMAND - 命令参数无效
• IRISCTL_INVALID_CONFIGURATION - 未定义的配置
• IRISCTL_CONTROL_STU_ERROR - ^STU 失败

错误返回后，IRISctlGetLastError 返回一个指向错误信息字符串的指针。