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 |