Función IoUpdateLinkShareAccess (wdm.h)

  • Artículo

La rutina IoUpdateLinkShareAccess actualiza el acceso de recurso compartido para el objeto de archivo especificado, normalmente cuando se abre el archivo.

Sintaxis

void IoUpdateLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

Parámetros

[in] FileObject

Puntero al objeto de archivo, que normalmente está cerrado por el subproceso 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, out, optional] LinkShareAccess

Puntero a la estructura de datos de acceso compartido de vínculo común (LINK_SHARE_ACCESS) asociada a FileObject. Los controladores deben tratar esta estructura como opaca.

Valor devuelto

None

Observaciones

IoUpdateLinkShareAccess no es una operación atómica. Por lo tanto, los controladores que llaman a esta rutina deben proteger el objeto de archivo compartido pasado a IoUpdateLinkShareAccess por medio de algún tipo de bloqueo, como una exclusión mutua o un bloqueo de recursos, para evitar daños en los recuentos de acceso compartido.

Antes de llamar a IoUpdateLinkShareAccess, el autor de la llamada debe llamar correctamente a IoCheckLinkShareAccess con Update establecido en False. Esta llamada a IoCheckLinkShareAccess determina si el acceso compartido solicitado es compatible con la forma en que otros abre el objeto de archivo, pero no actualiza la estructura de SHARE_ACCESS . IoUpdateLinkShareAccess actualiza realmente la estructura de SHARE_ACCESS asociada al objeto de archivo.

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
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Consulte también

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess