Função IoCheckFunctionAccess (ntifs.h)

Artigo
02/29/2024

A rotina IoCheckFunctionAccess verifica os parâmetros e o acesso de uma função em relação ao acesso atual concedido ao arquivo.

Sintaxe

NTSTATUS IoCheckFunctionAccess(
  ACCESS_MASK GrantedAccess,
  UCHAR       MajorFunction,
  UCHAR       MinorFunction,
  ULONG       IoControlCode,
  PVOID       Arg1,
  PVOID       Arg2
);

Parâmetros

GrantedAccess

Valor de máscara que especifica o acesso atualmente concedido ao arquivo para o chamador.

MajorFunction

Código de função principal para a operação que está sendo executada.

MinorFunction

Código de função secundária para a operação que está sendo executada.

IoControlCode

Código de controle de função de E/S para um código de E/S do sistema de arquivos ou dispositivo.

Arg1

Argumento opcional que depende da função principal. Esse parâmetro aponta para um dos valores de enumeração FILE_INFORMATION_CLASS se MajorFunction indicar que uma função de consulta ou definir informações de arquivo está sendo executada.

Arg2

Segundo argumento opcional que depende da função principal. Esse parâmetro aponta para um dos valores de enumeração FS_INFORMATION_CLASS . Esse parâmetro deverá ser fornecido se MajorFunction indicar que uma função de consulta ou definir informações de arquivo está sendo executada.

Retornar valor

IoCheckFunctionAccess retornará STATUS_SUCCESS se o chamador tiver acesso ao arquivo; caso contrário, retornará STATUS_ACCESS_DENIED.

Comentários

A máscara GrantedAccess não pode conter mapeamentos genéricos. Ou seja, IoCheckDesiredAccess deve ter sido invocado anteriormente para retornar uma máscara completa.