Función IoUpdateLinkShareAccess (wdm.h)
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 |