Função FindSyncContextFromName (filehc.h)

Artigo
02/26/2024

Recupera a estrutura FIO_CONTEXT associada ao nome de usuário especificado.

Sintaxe

FILEHC_EXPORT BOOL FindSyncContextFromName(
  [in]  PNAME_CACHE_CONTEXT pNameCache,
  [in]  LPBYTE              lpbName,
  [in]  DWORD               cbName,
  [in]  CACHE_READ_CALLBACK pfnCallback,
  [in]  LPVOID              lpvClientContext,
  [in]  HANDLE              hToken,
  [in]  ACCESS_MASK         accessMask,
  [out] FIO_CONTEXT         **ppContext
);

Parâmetros

[in] pNameCache

Um ponteiro para o cache de nomes que o cliente deve usar.

[in] lpbName

Um ponteiro para o nome do item armazenado em cache.

[in] cbName

O tamanho, em bytes, do valor em lpbName.

[in] pfnCallback

Um ponteiro para uma função FCACHE_READ_CALLBACK .

Nota Se esse parâmetro for NULL, nenhuma função de retorno de chamada será chamada.

[in] lpvClientContext

Um ponteiro para o contexto associado ao cliente. Esse contexto é passado para a função de retorno de chamada.

[in] hToken

Solicite o cache para avaliar o descritor de segurança inserido. Se hToken for zero, ele será ignorado.

[in] accessMask

Os dados do descritor de segurança. Para obter mais informações, consulte ACCESS_MASK.

[out] ppContext

Um ponteiro para um ponteiro para a estrutura FIO_CONTEXT associada ao nome de usuário.

Se a função retornar TRUE, esse parâmetro poderá retornar um ponteiro NULL . Isso ocorre quando o usuário passa uma FIO_CONTEXT NULL para _AssociateContextWithName.