UDT“Conf_ClientId” (S7-1500) UDT“Conf_ClientId” UDT“Conf_ClientId”用于读取或更改“DHCP ClientId”通信参数。可使用 DHCP 为每个接口单独 确定参数。 UDT“Conf_ClientId”的结构如下： 参数 数据类型 ClientId 字符串[254] 主机名、域名和 ClientId 的总长度不得超过 260 个字符。主机名和域名的组合不得超过 254 个字符（包括定界符），并且必须形成 FQDN。末尾不必添加定界符，因为 root-label 始终 为空。 如果使用 UDT“Conf_ClientId”，则必须为 HW_ID 选择一个“HW_Interface”类型的值。 对于“ClientId”，仅允许使用 0x21 到 0x7E 之间的 ASCII 字符。如果违反此规则， “CommConfig”将返回错误 0x8094（DATA 引用的 UDT 中的值无效）。 “ClientId”的长度必须为 0 或介于 2 到 254 之间。长度为 1 的字符串将导致错误 0x8094。 如果输入长度为 0 的字符串（空字符串），则“CommConfig”会在 DHCP 参数的数据记录中 写入一个空 ClientId。如果 ClientId 为空，则 DHCP 客户端会在 DHCP 服务器上使用 MAC 地 址自行识别。Zui大长度为 252 个字符。主机名和域名的组合不得超过 254 个字符（包括定界符），并且 必须形成 FQDN。末尾不必添加定界符，因为 root-label 始终为空。主机名、域名和 ClientId 的总长度不得超过 260 个字符。 如果使用 UDT“Conf_Domainname”，则必须为 HW_ID 选择一个“HW_SubModule”类型的值。 可以在 RFC1035 和 RFC1123 中找到允许的字符。 说明 通过 DHCP 获取的数据的有效性 如果使用“CommConfig”更改域名，则通过 DHCP 获取的所有数据都将失效：IP 套件、域名、 NTP 服务器和 DNS 服务器。因此，仅应在紧急情况下而不是运行期间更改域名。 如果接口的 IP 地址发生更改，则所有连接都会中断。

              如果输入长度为 2 到 254 之间的字符串，则存在以下两种不同的情况： • 字符串以转义序列“\0”开头。在这种情况下，“CommConfig”会从字符串中删除转义序列， 并将其替换为 0x00。 • 字符串不以转义序列“\0”开头。在这种情况下，字符串会原样复制到 DHCP 参数的数据记 录中。 读取期间，通信参数“DHCP ClientId”适用以下规则：如果读取的第一个字节的值为 0x00，则 它将替换为“\0”。读取期间，不会检查是否允许读取的字符。因此，并非所有读取的字符都 可以正确显示。如果读取的 ClientId 不适合 UDT“Conf_ClientId”的字段“ClientId”，则输出错 误 0x80B7（范围无效）。 说明 通过 DHCP 获取的数据的有效性 如果使用“CommConfig”更改 ClientId，则通过 DHCP 获取的所有数据都将失效：IP 套件、域 名、NTP 服务器和 DNS 服务器。因此，仅应在紧急情况下而不是运行期间更改 ClientId。 如果接口的 IP 地址发生更改，则所有连接都会中断。 说明 写入 ClientId 如果将 DHCP 组态为使用 ClientId，则只能用“CommConfig”写入 ClientId。 UDT“Conf_ClientId_Opaque” (S7-1500) UDT“Conf_ClientId_Opaque” UDT“Conf_ClientId_Opaque”用于读取或更改“DHCP ClientId”通信参数。与使用 UDT “Conf_ClientId”相比，UDT“Conf_ClientId_Opaque”提供了更大的灵活性。 UDT“Conf_ClientId_Opaque”的结构如下： 参数 数据类型 长度 字节 ClientId 字节组成的数组[0 .. 253] 主机名、域名和 ClientId 的总长度不得超过 260 个字符。主机名和域名的组合不得超过 254 个字符（包括定界符），并且必须形成 FQDN。末尾不必添加定界符，因为 root-label 始终 为空。UDT“Conf_ClientId”和“Conf_ClientId_Opaque”之间的区别在于，使用 “Conf_ClientId_Opaque”时，您不受字符限制。“CommConfig”仅检查“长度”参数的值。 “Length”的值必须为 0 或介于 2 和 254 之间。其它值会导致错误 0x8094（DATA 引用的 UDT 中的值无效）。 使用 UDT“Conf_ClientId_Opaque”时与使用 UDT“Conf_ClientId”时一样，不会对转义序列“\0” 进行特殊处理。您可能必须使用 0x00 作为“ClientId”字段中的第一个字节。 说明 使用 UDT“Conf_ClientId”和“Conf_ClientId_Opaque” 使用 UDT“Conf_ClientId”或 UDT“Conf_ClientId_Opaque”。 说明 通过 DHCP 获取的数据的有效性 如果使用“CommConfig”更改 ClientId，则通过 DHCP 获取的所有数据都将失效：IP 套件、域 名、NTP 服务器和 DNS 服务器。因此，仅应在紧急情况下而不是运行期间更改 ClientId。 旧地址失效后，可以立即中断通过 IP 套件建立的所有连接。 说明 写入 ClientId 如果将 DHCP 组态为使用 ClientId，则只能用“CommConfig”写入 ClientId。 UDT“Conf_DNS” (S7-1500) UDT“Conf_DNS” UDT“Conf_DNS”提供了一个接口来读取或更改 CPU 的 DNS 服务器的地址。 UDT“Conf_DNS”的结构如下： 参数 数据类型 计数 UInt DNS_Server Array[1 ..4] of String[39] UDT“Conf_DNS”的接口仅支持 IPv4 地址。 在“计数”参数“CommConfig”中，输入读取的 DNS 服务器的数量，或指定 DNS 服务器的数 量。允许的值为 0 到 4。如果值为 0，则未组态任何 DNS 服务器，或者您要删除所有已组态的 DNS 服务器。如果值大于 4，则“CommConfig”将返回错误 0x8094（DATA 引用的 UDT 中 的值无效）。如果在“DNS_Server”参数中分配了三个字段元素，但仅在“计数”参数中指定 了值 2，则不会组态第三个 DNS 服务器。在这种情况下，“CommConfig”不会返回错误。如 果在“DNS_Server”参数中分配了三个字段元素但在“计数”参数中指定了值 4，则 “CommConfig”将返回错误 0x8094。“CommConfig”不允许您为 DNS 服务器指定地址 0.0.0.0。 DNS 服务器的 IP 地址在参数“DNS_Server”中定义为字符串。“DNS_Server”参数由一个字符串 字段组成。此字符串的格式必须为“www.xxx.yyy.zzz”，其中每个子字符串的范围为“000”到 “255”。因此，字符串Zui长为 15 个字符。索引为 1 的字段元素指定主 DNS 服务器，索引为 2 的字段元素指定主备用 DNS 服务器。如果指定了无效或格式错误的 IP 地址，则“CommConfig” 将返回错误 0x8094（DATA 引用的 UDT 中的值无效）。 说明 组态 DNS 服务器 每次使用 UDT“Conf_DNS”写入“CommConfig”时，都必须组态所有 DNS 服务器。 如果违反此规则，则将删除 CPU 中属于未分配字段元素的 DNS 服务器的地址。 如果想要更改 DNS 服务器的地址，则必须先使用“CommConfig”读取所有 DNS 服务器的地 址，然后将地址修改为可从本地更改，Zui后使用“CommConfig”再次写入所有地址。 UDT“Conf_DNS_IPV4” (S7-1500) UDT“Conf_DNS_IPV4” UDT“Conf_DNS_IPV4”提供与 UDT“Conf_DNS”相同的功能，但接口不同。 UDT“Conf_DNS_IPV4”的结构如下： 参数 数据类型 计数 UInt DNS_Server Array[1 ..4] of IP_V4 在“计数”参数“CommConfig”中，输入读取的 DNS 服务器的数量，或指定 DNS 服务器的数 量。允许的值为 0 到 4。如果值为 0，则未组态任何 DNS 服务器，或者您要删除所有已组态 的 DNS 服务器。如果值大于 4，则“CommConfig”将返回错误 0x8094（DATA 引用的 UDT 中 的值无效）。如果在“DNS_Server”参数中分配了三个字段元素，但仅在“计数”参数中指定 了值 2，则不会组态第三个 DNS 服务器。在这种情况下，“CommConfig”不会返回错误。如 果在“DNS_Server”参数中分配了三个字段元素但在“计数”参数中指定了值 4，则“CommConfig”将返回错误 0x8094。“CommConfig”不允许您为 DNS 服务器指定地址 0.0.0.0。 DNS 服务器的 IP 地址在参数“DNS_Server”中定义为 IP_V4 数据类型。“DNS_Server”参数由一 个 IP_V4 数据类型的字段组成。IP_V4 数据类型又由具有 4 个元素（索引 1 到 4）的字节字 段组成。每个字节的范围为“000”到“255”。这四个字节一起构成一个 IP 地址，其中索引为 1 的字段元素是 IP 地址的Zui大值字节。在“DNS_Server”字段中，索引为 1 的字段元素定义主 DNS 服务器，索引为 2 的字段元素定义主备用 DNS 服务器。 说明 组态 DNS 服务器 每次使用 UDT“Conf_DNS_IPV4”写入“CommConfig”时，都必须组态所有 DNS 服务器。 如果违反此规则，则将删除 CPU 中属于未分配字段元素的 DNS 服务器的地址。 如果想要更改 DNS 服务器的地址，则必须先使用“CommConfig”读取所有 DNS 服务器的地 址，然后将地址修改为可从本地更改，Zui后使用“CommConfig”再次写入所有地址。