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