RxNameCacheActivateEntry 関数 (namcache.h)

[アーティクル]
08/07/2023

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 ルーチンは、名前キャッシュエントリが空きリストまたはアクティブリストに存在しないことを前提としています。