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 |