使用远程控制面板 API

可使用这些 API 来编写可远程访问控制面板的程序。借助这些 API，您的程序可访问大量命令和查询。

“操作控制台”的远程控制面板功能提供了一组 API，系统管理员可使用这些 API 来通过程序控制系统。这些 API 允许定制程序与系统控制面板交互并执行大量常用系统控制面板功能。

仅当使用通过串行控制台电缆连接的远程控制面板时，才能使用这些 API。无法将这些 API 与通过并行电缆连接的虚拟控制面板或远程控制面板配合使用。

这些远程控制面板 API 的接口是通过标准 TCP/IP 套接字连接来建立的。该套接字连接可采用任何在 Windows 平台上支持套接字的编程语言（Java™、C/C++ 或 Visual Basic 等）实现。

要使用远程控制面板 API，请遵循下列步骤：

使用远程控制面板功能启动“操作控制台”。
从定制程序，在同一 PC 上打开与端口 2150 的套接字连接。
发送下面所述命令的集合中的受支持命令（对于每个 API 名称，按所显示的那样，使用大写和小写字母）。
接收在同一套接字连接上发送回的字节流。
必要时，在同一套接字连接上重复步骤 3 和 4。
完成时，关闭该套接字连接。

您的程序需要解释从系统发送回的字节流。返回的字节流由预定义的格式组成，该格式对于所有命令都相同。该字节流的长度至少为 4 个字节。一些命令会返回其他字节。

前 2 个字节（0 和 1）将返回命令状态，该状态通常为成功或失败。接下来的 2 个字节（2 和 3）将是一个 16 位数字 N，它告知有多少其他字节将在这前 4 个字节后面。如果 N 为非零，那么在字节 4 至 4 + N 中，将存在其他信息。此信息将是与命令相关的其他数据（例如 TRUE 或 FALSE）。

注：如果发送的命令不是下面定义的其中一个命令字符串，那么返回值的字节 0 和 1 中的返回码将为 32 (0x20)。这意味着命令不受支持。

您的程序可通过使用下列 API 来执行下列控制面板功能。