Función IoRemoveLinkShareAccess (wdm.h)

La rutina IoRemoveLinkShareAccess quita la información de acceso y vínculo de acceso compartido para una instancia abierta determinada de un objeto de archivo.

Sintaxis

VOID IoRemoveLinkShareAccess(
  [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 compartido común 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

Ninguno

Observaciones

Esta rutina es recíproca a IoUpdateLinkShareAccess.

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

Los autores de llamadas de ioRemoveLinkShareAccess deben ejecutarse en IRQL = PASSIVE_LEVEL y en el contexto del subproceso que solicitó que se cerrara el FileObject de.

Requisitos

Consulte también

IoCheckLinkShareAccess

IoSetLinkShareAccess

ioUpdateLinkShareAccess