Функция 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 |
| Header | filehc.h |
| Библиотека | Fcachdll.lib |
| DLL | Fcachdll.dll |