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.
void IoUpdateLinkShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess,
[in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);
[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.
Ninguno
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.
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 |