broadcast 屬性
關鍵字 [broadcast] 指定將遠端程序呼叫傳送至區域網路上的所有伺服器。
[
interface-attribute-list
]
interface interface-name
{
[broadcast [, attribute-list]] returntype function-name(params)
}
-
interface-attribute-list
-
指定套用至介面整體之零個或多個 IDL 屬性的清單。 當有兩個或多個介面屬性時,它們必須以逗號分隔。
-
interface-name
-
指定介面的名稱。
-
attribute-list
-
指定要套用至函式的其他屬性。 以逗號分隔多個屬性。
-
returntype
-
指定函式的傳回型別。
-
function-name
-
指定要套用 [broadcast] 屬性的函式名稱。
-
params
-
函式參數清單。
[broadcast]關鍵字指定常式一律廣播到網路上的所有伺服器,而不是傳遞至一個特定伺服器。用戶端會收到第一個回復的輸出,以成功傳回,而後續的回復則會被捨棄。
具有 [broadcast] 屬性的作業隱含 為 [等冪] 作業。 不過, [broadcast] 屬性會指定具有 [等冪] 屬性之函式沒有的其他屬性。 具體而言,使用 [broadcast] 屬性的函式會指定常式可以呼叫多次,做為一個遠端程序呼叫的結果。 同時,它們可以傳送至多部伺服器。 這與 [idempotent] 屬性不同,這會指定只有在未完成時,才能重試呼叫。
如果遠端程式將其呼叫廣播到區域網路上的所有主機,則必須使用 ncadg_ip_udp 或 ncadg_ipx 通訊協定序列。 請注意, [broadcast] 封包的大小是由使用中的資料包服務所決定。