Función IoSetLinkShareAccess (wdm.h)

  • Artículo

La rutina IoSetLinkShareAccess establece los derechos de acceso para compartir el objeto de archivo especificado.

Sintaxis

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

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 de 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 a la solicitud abierta actual.

[in, out] ShareAccess

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

[in, out, optional] LinkShareAccess

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

[in] IoShareAccessFlags

Máscara de bits de estas marcas:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) especifica que el usuario no tiene permiso de escritura para el archivo. Esta marca se usa para evitar abrir un archivo para el acceso de lectura exclusivo cuando el usuario no tiene los permisos adecuados.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) indica si se actualiza la estructura SHARE_ACCESS.

Valor devuelto

None

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1709
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Universal
Encabezado wdm.h
Library Ntoskrnl.lib

Consulte también

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess