RxNameCacheCreateEntry 関数 (namcache.h)

[アーティクル]
03/05/2024

RxNameCacheCreateEntry は、指定された名前文字列を使用してNAME_CACHE構造体を割り当てて初期化します。

構文

PNAME_CACHE RxNameCacheCreateEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name,
  [in] IN BOOLEAN             CaseInsensitive
);

パラメーター

[in] NameCacheCtl

エントリの割り当て元となるNAME_CACHE_CONTROL構造体へのポインター。

[in] Name

名前キャッシュエントリを初期化する Unicode 名文字列へのポインター。

[in] CaseInsensitive

Name パラメーターを比較するときに大文字と小文字を区別しない比較を使用するかどうかを示すブール値。

戻り値

RxNameCacheCreateEntry は、成功した場合は新しく割り当てられたNAME_CACHE構造体へのポインターを返し、割り当てが失敗した場合は NULL ポインターを返します。

注釈

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

RxNameCacheCreateEntry は、新しいNAME_CACHE エントリを割り当てる前に、空きリストのNAME_CACHE エントリを再利用しようとします (空きリストが使用可能な場合)。