RxNameCacheFetchEntry 関数 (namcache.h)

[アーティクル]
02/29/2024

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、一致に失敗した場合は NULL )。

注釈

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

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

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

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