RpcNsMgmtInqExpAge 関数 (rpcnsi.h)

RpcNsMgmtInqExpAge 関数は、名前サービス データのローカル コピーのグローバル有効期限を返します。

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

 

構文

RPC_STATUS RpcNsMgmtInqExpAge(
  unsigned long *ExpirationAge
);

パラメーター

ExpirationAge

既定の有効期限 (秒単位) へのポインター。 この値は、すべての name service next 操作で使用されます。

戻り値

値	意味
RPC_S_OK	呼び出しは成功しました。

 

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

 

注釈

RpcNsMgmtInqExpAge 関数は、アプリケーションが使用している有効期限を返します。 有効期限は、name-service 属性のデータのローカル コピーが存在してから、その属性のアプリケーションからの要求でローカル コピーの更新が必要になるまでの時間 (秒単位) です。 アプリケーションの実行が開始されると、RPC ランタイム ライブラリは既定の有効期限を 2 時間に指定します。 既定値は、アプリケーションのグローバルです。

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

通常、アプリケーションでは既定の有効期限のみを使用する必要があります。 ただし、特別なケースでは、 RpcNsMgmtSetExpAge を呼び出すことで、アプリケーションでユーザー指定のグローバル有効期限を既定に置き換えることができます。 RpcNsMgmtInqExpAge 関数は、既定値かユーザー指定の値かにかかわらず、現在のグローバル有効期限を返します。 アプリケーションは、 RpcNsMgmtHandleSetExpAge 関数を呼び出すことによって、グローバル有効期限を一時的にオーバーライドすることもできます。

要件

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

こちらもご覧ください

RpcNsMgmtHandleSetExpAge

RpcNsMgmtSetExpAge