Función IoUpdateLinkShareAccess (wdm.h)

El IoUpdateLinkShareAccess rutina actualiza el acceso al 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 compartido 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 compartido de vínculo común (LINK_SHARE_ACCESS) asociada a FileObject. Los controladores deben tratar esta estructura como opaca.

Valor devuelto

Ninguno

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, con el fin de 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	Valor
cliente mínimo admitido	Windows 10, versión 1709
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Universal
encabezado de	wdm.h
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL

Consulte también

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess