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 の