RpcNsMgmtSetExpAge 関数 (rpcnsi.h)

RpcNsMgmtSetExpAge 関数は、名前サービス データのローカル コピーのアプリケーションのグローバル有効期限を変更します。

メモ この関数は、Windows Vista 以降のオペレーティング システムではサポートされていません。

 

構文

RPC_STATUS RpcNsMgmtSetExpAge(
  unsigned long ExpirationAge
);

パラメーター

ExpirationAge

既定の有効期限 (秒単位) へのポインター。 この値は、すべての name service-next 操作で使用されます。 有効期限が 0 の場合、ローカルのネーム サービス データが直ちに更新されます。

有効期限を RPC 割り当て既定値の 2 時間にリセットするには、値RPC_C_NS_DEFAULT_EXP_AGEを指定します。

戻り値

値	説明
RPC_S_OK	呼び出しは成功しました。
RPC_S_NAME_SERVICE_UNAVAILABLE	名前サービスを利用できません。

 

メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。

 

解説

RpcNsMgmtSetExpAge 関数は、アプリケーションのグローバル有効期限を変更します。 有効期限は、name-service 属性のデータのローカル コピーが存在し、その属性に対するアプリケーションからの要求でローカル コピーの更新が必要になるまでの時間です。 アプリケーションの実行が開始されると、RPC ランタイム ライブラリは既定の有効期限を 2 時間に指定します。 既定値は、アプリケーションに対するグローバルです。 通常、 RpcNsMgmtSetExpAge の使用は避ける必要があります。 代わりに、既定の有効期限に依存する必要があります。

有効期限は、ポインターの次の操作 (名前サービス属性からデータを読み取る) によって使用されます。 次の操作は、通常、アプリケーションによって要求される属性データのローカル コピーを検索することから始まります。 ローカル コピーがない場合、次の操作では、name-service データベースからの新しい属性データを含むコピーが作成されます。 ローカル コピーが既に存在する場合、操作は実際の有効期間と、アプリケーションで使用されている有効期限を比較します。 実際の有効期間が有効期限を超えた場合、操作は自動的に新しい属性データを使用してローカル コピーの更新を試みます。 更新が不可能な場合、古いローカル データはそのまま残り、次の操作は失敗し、RPC_S_NAME_SERVICE_UNAVAILABLE状態コードが返されます。

有効期限を小さい値に設定すると、ポインターの次の操作によって、アプリケーションによって要求されたすべての name-service 属性のローカル データが頻繁に更新されます。 たとえば、有効期限を 0 に設定すると、次のすべての操作で、アプリケーションによって要求された name-service 属性のローカル データが更新されます。 そのため、有効期限を小さく設定すると、アプリケーションのパフォーマンスの問題が発生し、ネットワーク トラフィックが増加する可能性があります。 さらに、アプリケーションでリモート ネーム サービス サーバーを使用している場合、有効期限が小さいと、すべてのアプリケーションのネットワーク パフォーマンスに悪影響を及ぼす可能性があります。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	rpcnsi.h (Rpc.h を含む)
Library	Rpcns4.lib
[DLL]	Rpcns4.dll

関連項目

RpcNsMgmtHandleSetExpAge