次の方法で共有


RxNameCacheCreateEntry 関数 (namcache.h)

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構造体の有効期間 (秒単位) と コンテキスト メンバーを設定した後、RxNameCacheActivateEntry 呼び出して、名前キャッシュアクティブ リストにエントリを配置することが期待されます。

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

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー namcache.h (Namcache.h を含む)
IRQL <= APC_LEVEL

関連項目

RxNameCacheActivateEntry

RxNameCacheCheckEntry

RxNameCacheExpireEntry

RxNameCacheExpireEntryWithShortName

RxNameCacheFetchEntry

RxNameCacheFinalize

RxNameCacheFreeEntry

RxNameCacheInitialize