Función IoUpdateShareAccess (wdm.h)

  • Artículo

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)

Consulte también

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess