Função FileAttr

Aplica-se a
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

Observação

A função, o método, o objeto ou a propriedade descrita neste tópico será desabilitada se o Serviço de Expressão do Microsoft Jet estiver em execução no modo de área restrita, o que impede a avaliação de expressões potencialmente inseguras. Para obter mais informações sobre o modo sandbox, pesquise "modo sandbox" na Ajuda.

Retorna um Long representando o modo de arquivo para arquivos abertos usando a instrução Open .

Sintaxe

FileAttr(filenumber,returntype)

A sintaxe da função FileAttr tem estes argumentos:

Argumento Descrição
número do arquivo Obrigatório. Inteiro. Qualquer número de arquivo válido.
ReturnType Obrigatório. Inteiro. Número que indica o tipo de informação a ser retornada. Especifique 1 para retornar um valor que indica o modo de arquivo. Somente em sistemas de 16 bits, especifique 2 para recuperar um identificador de arquivo do sistema operacional. ReturnType 2 não é compatível com sistemas de 32 bits e causa um erro.

Valores retornados

Quando o argumento returntypeé 1, os seguintes valores retornados indicam o modo de acesso ao arquivo:

Modo Valor
Entrada 1
Saída 2
Aleatório 4
Acréscimo 8
Binário 32

Exemplo

Observação

Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função FileAttr para retornar o modo de arquivo e o identificador de arquivo de um arquivo aberto. O identificador do arquivo é retornado apenas em sistemas de 16 bits; Em sistemas de 32 bits, passar 2 como segundo argumento gera um erro.

Dim FileNum, Mode, Handle
FileNum = 1    ' Assign file number.
Open "TESTFILE" For Append As FileNum    ' Open file.
Mode = FileAttr(FileNum, 1) ' Returns 8 (Append file mode).
Handle = FileAttr(FileNum, 2) ' Returns file handle.
Close FileNum    ' Close file.