Función IoCheckFunctionAccess (ntifs.h)

Artículo
02/29/2024

La rutina IoCheckFunctionAccess comprueba los parámetros y el acceso de una función con respecto al acceso concedido actual al archivo.

Sintaxis

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

Parámetros

GrantedAccess

Valor de máscara que especifica el acceso concedido actualmente al archivo para el autor de la llamada.

MajorFunction

Código de función principal para la operación que se está realizando.

MinorFunction

Código de función secundaria para la operación que se está realizando.

IoControlCode

Código de control de funciones de E/S para un código de E/S del sistema de archivos o dispositivo.

Arg1

Argumento opcional que depende de la función principal. Este parámetro apunta a uno de los valores de enumeración FILE_INFORMATION_CLASS si MajorFunction indica que se está realizando una consulta o una función de información de archivo establecida.

Arg2

Segundo argumento opcional que depende de la función principal. Este parámetro apunta a uno de los valores de enumeración de FS_INFORMATION_CLASS . Este parámetro debe proporcionarse si MajorFunction indica que se está realizando una función de información de archivo de consulta o de establecimiento.

Valor devuelto

IoCheckFunctionAccess devuelve STATUS_SUCCESS si el autor de la llamada tiene acceso al archivo; de lo contrario, devuelve STATUS_ACCESS_DENIED.

Comentarios

La máscara de GrantedAccess no puede contener ninguna asignación genérica. Es decir, IoCheckDesiredAccess debe haberse invocado previamente para devolver una máscara completa.