Função IoUpdateShareAccess (wdm.h)

  • Artigo

A rotina IoUpdateShareAccess atualiza o acesso de compartilhamento para o objeto de arquivo fornecido, geralmente quando o arquivo está sendo aberto.

Sintaxe

void IoUpdateShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

Parâmetros

[in] FileObject

Ponteiro para um objeto de arquivo referenciado que representa o arquivo ou objeto de dispositivo associado para o qual atualizar o acesso de compartilhamento.

[in, out] ShareAccess

Ponteiro para a estrutura de SHARE_ACCESS comum associada ao FileObject. Os drivers devem tratar essa estrutura como opaca.

Retornar valor

Nenhum

Comentários

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

Antes de chamar IoUpdateShareAccess, o chamador deve chamar IoCheckShareAccess com Atualização definida como False. Essa chamada para IoCheckShareAccess determina se o acesso compartilhado solicitado é compatível com a maneira como o objeto de arquivo está sendo acessado por outras aberturas, mas não atualiza a estrutura SHARE_ACCESS . IoUpdateShareAccess realmente atualiza a estrutura SHARE_ACCESS associada ao objeto de arquivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Confira também

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess