Função IoCheckShareAccess (wdm.h)

Artigo
08/08/2023

A rotina IoCheckShareAccess é chamada por FSDs (drivers do sistema de arquivos) ou outros drivers de nível mais alto para marcar se o acesso compartilhado a um objeto de arquivo é permitido.

Sintaxe

NTSTATUS IoCheckShareAccess(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update
);

Parâmetros

[in] DesiredAccess

Especifica um valor ACCESS_MASK que indica o tipo desejado de acesso ao FileObject fornecido para a solicitação aberta atual. Os drivers calculam o valor desse parâmetro tomando o acesso solicitado na solicitação IRP_MJ_CREATE e, em seguida, aplicando SeAccessCheck para cada descritor de segurança para determinar o acesso real concedido. Se o acesso concedido for mais restritivo do que o acesso desejado, isso será um erro e o driver deverá concluir o IRP atual com um status de STATUS_ACCESS_DENIED. (Observe que SeAccessCheck limpa o bit MAXIMUM_ALLOWED no acesso concedido; não use esse bit ao comparar o acesso desejado ao acesso concedido.) Em seguida, o driver passa o acesso concedido como o valor de DesiredAccess.

[in] DesiredShareAccess

Especifica o tipo desejado de acesso compartilhado ao FileObject para a solicitação aberta atual. O valor desse parâmetro geralmente é o mesmo que o ShareAccess passado para o sistema de arquivos ou o driver de nível mais alto pelo gerente de E/S quando a solicitação aberta foi feita. Esse valor pode ser zero ou qualquer combinação do seguinte:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Ponteiro para o objeto de arquivo para o qual marcar acesso para a solicitação aberta atual.

[in, out] ShareAccess

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

[in] Update

Especifica se o status de acesso de compartilhamento deve ser atualizado para FileObject. Um valor booliano de TRUE significa que essa rotina atualizará as informações de acesso de compartilhamento para o objeto de arquivo se a solicitação aberta for permitida.

Retornar valor

IoCheckShareAccess retornará STATUS_SUCCESS se o acesso do solicitante ao objeto de arquivo for compatível com a maneira como ele está aberto no momento. Se a solicitação for negada devido a uma violação de compartilhamento, STATUS_SHARING_VIOLATION será retornado.

Comentários

IoCheckShareAccess verifica uma solicitação de abertura de objeto de arquivo para determinar se os tipos de acessos desejados e compartilhados especificados são compatíveis com a maneira como o objeto de arquivo está sendo acessado por outros abre.

Os sistemas de arquivos mantêm o estado sobre arquivos por meio de estruturas chamadas FCBs (blocos de controle de arquivos). O SHARE_ACCESS é uma estrutura que descreve como o arquivo é acessado atualmente por todos é aberto. Esse estado está contido no FCB como parte do estado aberto para cada objeto de arquivo. Cada objeto de arquivo deve ter apenas uma estrutura de acesso de compartilhamento. Outros drivers de nível mais alto podem chamar essa rotina para marcar o acesso solicitado quando um objeto de arquivo que representa esse objeto de dispositivo do driver é aberto.

IoCheckShareAccess não é uma operação atômica. Portanto, os drivers que chamam essa rotina devem proteger o objeto de arquivo compartilhado passado para IoCheckShareAccess 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.

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), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)