广播属性
关键字 (keyword) [broadcast] 指定将远程过程调用发送到本地网络上的所有服务器。
[
interface-attribute-list
]
interface interface-name
{
[broadcast [, attribute-list]] returntype function-name(params)
}
parameters
-
interface-attribute-list
-
指定应用于接口的零个或多个 IDL 属性的列表, 作为一个整体。 如果存在两个或多个接口属性,则必须用逗号分隔它们。
-
interface-name
-
指定接口的名称。
-
attribute-list
-
指定要应用于函数的其他属性。 用逗号分隔多个属性。
-
returntype
-
指定函数的返回类型。
-
function-name
-
指定将应用 [broadcast] 属性的函数的名称。
-
params
-
函数参数列表。
备注
[broadcast] 关键字 (keyword) 指定例程始终广播到网络上的所有服务器,而不是传递到一个特定的服务器。客户端接收来自第一个答复的输出以成功返回,而后续答复将被丢弃。
具有 [broadcast] 属性的操作是隐式 的 [幂等] 操作。 但是, [broadcast] 属性指定具有 [幂等] 属性的函数没有的其他属性。 具体而言,使用 [broadcast] 属性的函数指定作为一个远程过程调用的结果可以多次调用例程。 同时,它们可以发送到多个服务器。 这与 [幂等] 属性不同,后者仅指定在调用未完成时可以重试。
如果远程过程将其调用广播到本地网络上的所有主机,则必须使用 ncadg_ip_udp 或 ncadg_ipx 协议序列。 请注意, [广播] 数据包的大小由正在使用的数据报服务决定。
另请参阅