Função IoSetLinkShareAccess (wdm.h)

  • Artigo

A rotina IoSetLinkShareAccess define os direitos de acesso para o compartilhamento de link do objeto de arquivo especificado.

Sintaxe

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

Parâmetros

[in] DesiredAccess

Especifica um valor ACCESS_MASK que indica o tipo de acesso desejado 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 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 comum de dados de acesso de compartilhamento associada a FileObject. Os drivers devem tratar essa estrutura como opaca.

[in, out, optional] LinkShareAccess

Um ponteiro para a estrutura de dados de acesso de compartilhamento de link comum (LINK_SHARE_ACCESS) associada ao FileObject. Os drivers devem tratar essa estrutura como opaca.

[in] IoShareAccessFlags

Uma máscara de bits desses sinalizadores:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) especifica que o usuário não tem permissão de gravação para o arquivo. Esse sinalizador é usado para impedir a abertura de um arquivo para acesso de leitura exclusivo quando o usuário não tem as permissões apropriadas.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) indica se a estrutura de SHARE_ACCESS está atualizada.

Retornar valor

Nenhum

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Universal
Cabeçalho wdm.h
Biblioteca Ntoskrnl.lib

Confira também

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess