Función IoUpdateShareAccess (wdm.h)
La rutina IoUpdateShareAccess actualiza el acceso de recurso compartido para el objeto de archivo especificado, normalmente cuando se abre el archivo.
Sintaxis
void IoUpdateShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
Parámetros
[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 objeto FileObject. Los controladores deben tratar esta estructura como opaca.
Valor devuelto
None
Observaciones
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 mediante 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 a IoCheckShareAccess con Update establecido en False. Esta llamada a IoCheckShareAccess determina si el acceso compartido solicitado es compatible con la forma en que otros se 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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |