RxNameCacheFetchEntry 関数 (namcache.h)

RxNameCacheFetchEntry 、NAME_CACHE エントリの指定した名前文字列との一致が検索されます。

構文

PNAME_CACHE RxNameCacheFetchEntry(
  [in] IN PNAME_CACHE_CONTROL NameCacheCtl,
  [in] IN PUNICODE_STRING     Name
);

パラメーター

[in] NameCacheCtl

スキャンするNAME_CACHE_CONTROL構造体へのポインター。

[in] Name

一致する名前を含む Unicode 文字列へのポインター。

戻り値

RxNameCacheFetchEntry 、一致が見つかった場合は一致するNAME_CACHE構造体へのポインターを返し、一致が失敗した場合は NULL を します。

備考

RxNameCacheFetchEntry 、指定した Name パラメーターの名前キャッシュアクティブ リストで一致するものを検索します。 名前が見つかった場合、エントリは名前キャッシュアクティブ リストから削除され、NAME_CACHE構造体へのポインターが返されます。 それ以外の場合は、NULL が返されます。

NAME_CACHEエントリは、同じエントリを更新しようとしている別のスレッドで発生する可能性のある問題を回避するため、または有効期限が切れたことを確認して空きリストに配置するために、アクティブなリストから削除されます。 異なるスレッドによって同じ名前の複数のエントリを取得できますが、最終的には有効期限が切れます。

一致するNAME_CACHEエントリが見つかった場合、有効期限のチェックは行われません。 呼び出し元は、何らかの特別なアクションを実行する必要があるため、有効期限を確認する必要があります。

名前キャッシュのアクティブ なリストがスキャンされるときの副作用として、有効期限が切れている一致しないエントリは空きリストに置かれます。 この操作を保護するために、名前キャッシュ ロックが取得されます。

必要条件

関連項目

RxNameCacheActivateEntry の

RxNameCacheCheckEntry の

RxNameCacheCreateEntry の

RxNameCacheExpireEntry の

RxNameCacheExpireEntryWithShortName の

RxNameCacheFinalize の

RxNameCacheFreeEntry の

RxNameCacheInitialize の