Função IoRemoveLinkShareAccess (wdm.h)

A rotina IoRemoveLinkShareAccess remove o acesso e vincula informações de acesso de compartilhamento para uma determinada instância aberta de um objeto de arquivo.

Sintaxe

void IoRemoveLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

Parâmetros

[in] FileObject

Ponteiro para o objeto de arquivo, que geralmente está sendo fechado pelo thread atual.

[in, out] ShareAccess

Um ponteiro para a estrutura comum de dados de acesso de compartilhamento associada a FileObject. Os drivers devem tratar essa estrutura como opaca.

[in, out, optional] LinkShareAccess

Um ponteiro para a estrutura de dados de acesso de compartilhamento de link comum (LINK_SHARE_ACCESS) associada ao FileObject. Os drivers devem tratar essa estrutura como opaca.

Retornar valor

Nenhum

Comentários

Essa rotina é recíproca para IoUpdateLinkShareAccess.

IoRemoveLinkShareAccess não é uma operação atômica. Portanto, os drivers que chamam essa rotina devem proteger o objeto de arquivo compartilhado passado para IoRemoveLinkShareAccess por meio de algum tipo de bloqueio, como um mutex ou um bloqueio de recurso, a fim de evitar a corrupção das contagens de acesso compartilhado.

Os chamadores de IoRemoveLinkShareAccess devem estar em execução em IRQL = PASSIVE_LEVEL e no contexto do thread que solicitou que o FileObject fosse fechado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Universal
Cabeçalho	wdm.h
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Confira também

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess