Función IoUpdateShareAccess (wdm.h)
El IoUpdateShareAccess rutina actualiza el acceso al recurso compartido del objeto de archivo dado, normalmente cuando se abre el archivo.
void IoUpdateShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
[in] FileObject
Puntero a un objeto de archivo al que se hace referencia que representa el archivo o el objeto de dispositivo asociado para el que se va a actualizar el acceso al recurso compartido.
[in, out] ShareAccess
Puntero a la estructura de SHARE_ACCESS común asociada al FileObject de. Los controladores deben tratar esta estructura como opaca.
Ninguno
ioUpdateShareAccess 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 IoUpdateShareAccess 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 ioUpdateShareAccess, el autor de la llamada debe llamar correctamente IoCheckShareAccess con Update establecido en False. Esta llamada a ioCheckShareAccess 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. IoUpdateShareAccess actualiza realmente la estructura de SHARE_ACCESS asociada al objeto de archivo.
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |