Função IoCheckShareAccessEx (wdm.h)

Artigo
02/27/2024

A rotina IoCheckShareAccessEx é 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 IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Parâmetros

[in] DesiredAccess

Especifica um valor ACCESS_MASK que indica o tipo desejado de acesso ao objeto de arquivo fornecido.

[in] DesiredShareAccess

Especifica o tipo desejado de acesso compartilhado ao objeto de arquivo para a solicitação aberta atual. O valor desse parâmetro geralmente é o mesmo que o parâmetro ShareAccess que é passado para o sistema de arquivos ou o driver de nível mais alto pelo gerenciador 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

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

[in, out] ShareAccess

Um 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.

[in] WritePermission

Especifica se o acesso de compartilhamento tem permissão de gravação. Esse valor será TRUE se o compartilhamento tiver permissão de gravação; caso contrário, FALSE. Se o valor for FALSE e o acesso de compartilhamento tiver permissão de gravação e o chamador tentar obter acesso de leitura exclusivo, a permissão de gravação será rebaixada para FILE_SHARE_READ. Esse valor será NULL se uma permissão de gravação marcar não for feita no acesso de compartilhamento.

Retornar valor

A rotina IoCheckShareAccessEx 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h
Biblioteca	Ntoskrnl.lib

Confira também

Rotinas do Gerente de E/S

Compartilhar via