Compartilhar via


Função IoUpdateShareAccess (wdm.h)

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 à FileObject. Os drivers devem tratar essa estrutura como opaca.

Valor de retorno

Nenhum

Observações

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 com êxito IoCheckShareAccess com Update definido 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 de SHARE_ACCESS. IoUpdateShareAccess realmente atualiza a estrutura de SHARE_ACCESS associada ao objeto de arquivo.

Requisitos

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

Consulte também

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess