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

Confira também

FIO_CONTEXT

GENERIC_MAPPING