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.

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 FileObject de. Los controladores deben tratar esta estructura como opaca.

Valor devuelto

Ninguno

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 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.

Requisitos

Consulte también

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess