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

Confira também

IoCheckLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess