AssociateContextWithName 関数 (filehc.h)

名前キャッシュに名前を挿入して、指定した FIO_CONTEXT 構造体を検索します。

構文

FILEHC_EXPORT BOOL AssociateContextWithName(
  [in] PNAME_CACHE_CONTEXT  pNameCache,
  [in] LPBYTE               lpbName,
  [in] DWORD                cbName,
  [in] LPBYTE               lpbData,
  [in] DWORD                cbData,
  [in] PGENERIC_MAPPING     pGenericMapping,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in] FIO_CONTEXT          *pContext,
  [in] BOOL                 fKeepReference
);

パラメーター

[in] pNameCache

使用するキャッシュの名前へのポインター。

[in] lpbName

キャッシュ項目の名前のユーザー指定バイト。

[in] cbName

キャッシュ項目に割り当てられる名前の長さ。

[in] lpbData

キャッシュ項目の名前に関連付ける任意のデータのユーザー指定バイト。

[in] cbData

名前に関連付ける任意のデータの長さ (バイト単位)。

[in] pGenericMapping

名前に関連付ける GENERIC_MAPPING 構造体へのポインター。

[in] pSecurityDescriptor

名前に関連付ける自己相対セキュリティ記述子。 この記述子は、ユーザーによって提供されます。

[in] pContext

FIO_CONTEXT構造体へのポインター。

[in] fKeepReference

FIO_CONTEXT構造体の参照を保持するかどうかを指定します。 TRUE に設定すると、参照は保持されます。

戻り値

関数が成功した場合は TRUE を返します。それ以外の場合は、 FALSE を返します。

解説

名前がキャッシュに既に存在する場合、この呼び出しは失敗し、 GetLastError は ERROR_DUP_NAMEを返します。

要件

対象プラットフォーム	Windows
ヘッダー	filehc.h
Library	Fcachdll.lib
[DLL]	Fcachdll.dll

関連項目

FIO_CONTEXT

GENERIC_MAPPING