Share via


べき等属性

[べき等] 属性は、操作が状態情報を変更しないことを指定し、実行されるたびに同じ結果を返します。 ルーチンを複数回実行すると、1 回実行した場合と同じ効果があります。

[
    interface-attribute-list
] 
interface interface-name 
{
    [idempotent [, attribute-list]] returntype function-name(params)
}

パラメーター

interface-attribute-list

インターフェイス全体に適用される 0 個以上の IDL 属性のリストを指定します。 2 つ以上のインターフェイス属性が存在する場合は、コンマで区切る必要があります。

interface-name

インターフェイスの名前を指定します。

attribute-list

関数に適用する追加の属性を指定します。 複数の属性をコンマで区切ります。

returntype

関数の戻り値の型を指定します。

function-name

[べき等] 属性を適用する関数の名前を指定します。

params

関数パラメーターの一覧。

解説

RPC では、2 種類のリモート呼び出しセマンティクスがサポートされています。[べき等] 属性を持つ操作の呼び出しと、[べき等] 属性 (べきでない操作) を使用しない操作 (べき等操作) の呼び出しです。 べき等操作は、無効な効果なしで複数回実行できます。 逆に、べき等でない操作は、毎回異なる結果を返すか、何らかの状態を変更するため、複数回実行することはできません。

呼び出しが完了しない場合にプロシージャが自動的に再実行されるようにするには、[ べき等] 属性を使用します。 [べき等][ブロードキャスト]、または [多分] 属性が存在しない場合、プロシージャは既定で非べき等セマンティクスを使用します。 この場合、操作は 1 回だけ実行されます。

関連項目

放送

インターフェイス定義 (IDL) ファイル

多分