RxNameCacheActivateEntry 関数 (namcache.h)

RxNameCacheActivateEntry 名前キャッシュ エントリを取得し、有効期限とネットワーク ミニ リダイレクター コンテキストを更新します。 次に、アクティブなリストに名前キャッシュ エントリを配置します。

構文

VOID RxNameCacheActivateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PNAME_CACHE         NameCache,
  [in] IN ULONG               LifeTime,
  [in] IN ULONG               MRxContext
);

パラメーター

[in] NameCacheCtl

エントリをアクティブ化するNAME_CACHE_CONTROL構造体へのポインター。

[in] NameCache

アクティブ化するNAME_CACHE構造体へのポインター。

[in] LifeTime

キャッシュ エントリの有効な有効期間を秒単位で示す値。 値 0 は、現在の値を変更せずに残すことを意味します。 値 0 は、元の有効期間を保持する一致後の再アクティブ化に使用されます。

[in] MRxContext

有効なエントリ チェックを行うときの等価チェックのために、ネットワーク ミニ リダイレクターによって提供されるコンテキストの値。 MRxContext 値が 0 の場合、現在の値は変更されません。 値 0 は、元の MRxContext 保持する一致後の再アクティブ化に使用されます。

戻り値

何一つ

備考

RxNameCacheActivateEntry ルーチンは、通常、ネットワーク ミニ リダイレクターが RxNameCacheCreateEntry を呼び出して、指定された名前文字列を使用してNAME_CACHE構造体を割り当てて初期化した後に呼び出されます。 呼び出し元は、名前キャッシュ コンテキストの追加のネットワーク ミニ リダイレクター要素 (有効期間 (秒単位) や MRxContext など) を初期化し、RxNameCacheActivateEntry 呼び出すことによって、名前キャッシュアクティブ リストにエントリを配置することが期待されます。

RxNameCacheActivateEntry ルーチンは、名前キャッシュ エントリが空きリストまたはアクティブ リストに含まれていないことを前提としています。

必要条件

関連項目

RxNameCacheCheckEntry の

RxNameCacheCreateEntry の

RxNameCacheExpireEntry の

RxNameCacheExpireEntryWithShortName の

RxNameCacheFetchEntry の

RxNameCacheFinalize の

RxNameCacheFreeEntry の

RxNameCacheInitialize の