Función IoCheckShareAccessEx (wdm.h)

Los controladores del sistema de archivos (FSD) llaman a la rutina IoCheckShareAccessEx u otros controladores de nivel superior para comprobar si se permite el acceso compartido a un objeto de archivo.

Sintaxis

NTSTATUS IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Parámetros

[in] DesiredAccess

Especifica un valor de ACCESS_MASK que indica el tipo de acceso deseado al objeto de archivo especificado.

[in] DesiredShareAccess

Especifica el tipo deseado de acceso compartido al objeto de archivo para la solicitud abierta actual. El valor de este parámetro suele ser el mismo que el parámetro shareAccess que se pasa al sistema de archivos o al controlador de nivel superior por el administrador de E/S cuando se realizó la solicitud abierta. Este valor puede ser cero o cualquier combinación de lo siguiente:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Puntero al objeto de archivo para el que se va a comprobar el acceso de la solicitud abierta actual.

[in, out] ShareAccess

Puntero a la estructura de datos de acceso a recursos compartidos común que está asociada a FileObject. Los controladores deben tratar esta estructura como opaca.

[in] Update

Especifica si se va a actualizar el estado de acceso a recursos compartidos para FileObject. Un valor booleano de TRUE significa que esta rutina actualizará la información de acceso al recurso compartido para el objeto de archivo si se permite la solicitud abierta.

[in] WritePermission

Especifica si el acceso al recurso compartido tiene permiso de escritura. Este valor es TRUE si el recurso compartido tiene permiso de escritura; de lo contrario, FALSE. Si el valor es FALSE y el acceso al recurso compartido tiene permiso de escritura y el autor de la llamada intenta obtener acceso de lectura exclusivo, el permiso de escritura se degrada a FILE_SHARE_READ. Este valor es NULL si no se realiza una comprobación de permisos de escritura en el acceso al recurso compartido.

Valor devuelto

La rutina IoCheckShareAccessEx devuelve STATUS_SUCCESS si el acceso del solicitante al objeto de archivo es compatible con la forma en que está abierto actualmente. Si se deniega la solicitud debido a una infracción de uso compartido, se devuelve STATUS_SHARING_VIOLATION.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	wdm.h
Library	Ntoskrnl.lib

Consulte también

Rutinas del administrador de E/S