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) |