Función IoRemoveLinkShareAccess (wdm.h)

La rutina IoRemoveLinkShareAccess quita el acceso y vincula la información 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 a recursos compartidos 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 a recursos compartidos (LINK_SHARE_ACCESS) común que está asociada a FileObject. Los controladores deben tratar esta estructura como opaca.

Valor devuelto

None

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, para 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 cierre fileObject .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Universal
Encabezado	wdm.h
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte también

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess