Função AssociateContextWithName (filehc.h)
Insere um nome no cache de nomes para encontrar uma estrutura de FIO_CONTEXT especificada.
Sintaxe
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
);
Parâmetros
[in] pNameCache
Um ponteiro para o nome do cache a ser usado.
[in] lpbName
Bytes especificados pelo usuário para o nome do item de cache.
[in] cbName
O comprimento do nome atribuído ao item de cache.
[in] lpbData
Bytes especificados pelo usuário para quaisquer dados arbitrários a serem associados ao nome do item de cache.
[in] cbData
O comprimento, em bytes, de dados arbitrários a serem associados ao nome.
[in] pGenericMapping
Um ponteiro para uma estrutura GENERIC_MAPPING a ser associada ao nome.
[in] pSecurityDescriptor
O descritor de segurança auto-relativo a ser associado ao nome. Esse descritor é fornecido pelo usuário.
[in] pContext
Um ponteiro para uma estrutura FIO_CONTEXT .
[in] fKeepReference
Especifica se a referência na estrutura de FIO_CONTEXT deve ser mantida. Se definido como TRUE, a referência será mantida.
Valor retornado
Retorna TRUE se a função for bem-sucedida; caso contrário, retornará FALSE.
Comentários
Se o nome já estiver presente no cache, essa chamada falhará e GetLastError retornará ERROR_DUP_NAME.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | filehc.h |
| Biblioteca | Fcachdll.lib |
| DLL | Fcachdll.dll |