RpcNsMgmtSetExpAge 関数 (rpcnsi.h)
RpcNsMgmtSetExpAge 関数は、名前サービス データのローカル コピーのアプリケーションのグローバル有効期限を変更します。
構文
RPC_STATUS RpcNsMgmtSetExpAge(
unsigned long ExpirationAge
);
パラメーター
ExpirationAge
既定の有効期限 (秒単位) へのポインター。 この値は、すべての name service-next 操作で使用されます。 有効期限が 0 の場合、ローカルのネーム サービス データが直ちに更新されます。
有効期限を RPC 割り当て既定値の 2 時間にリセットするには、値RPC_C_NS_DEFAULT_EXP_AGEを指定します。
戻り値
| 値 | 説明 |
|---|---|
|
呼び出しは成功しました。 |
|
名前サービスを利用できません。 |
解説
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 |