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] 封包的大小是由使用中的資料包服務所決定。

另請參閱

idempotent

介面定義 (IDL) 檔案

也許

ncadg_ip_udp

ncadg_ipx