Função IoSetShareAccessEx (wdm.h)

  • Artigo

A rotina IoSetShareAccessEx define os direitos de acesso para compartilhar o objeto de arquivo especificado.

Sintaxe

void IoSetShareAccessEx(
  [in]           ACCESS_MASK   DesiredAccess,
  [in]           ULONG         DesiredShareAccess,
  [in, out]      PFILE_OBJECT  FileObject,
  [out]          PSHARE_ACCESS ShareAccess,
  [in, optional] PBOOLEAN      WritePermission
);

Parâmetros

[in] DesiredAccess

Especifica um valor ACCESS_MASK que representa o tipo de acesso solicitado para o objeto de arquivo. Consulte IoCreateFile para obter uma lista completa de sinalizadores DesiredAccess definidos pelo sistema.

[in] DesiredShareAccess

Especifica o tipo de acesso de compartilhamento a ser definido para o objeto de arquivo. Esse valor pode ser zero ou qualquer combinação dos seguintes sinalizadores:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Um ponteiro para o objeto de arquivo cujo acesso de compartilhamento está sendo definido ou redefinido.

[out] ShareAccess

Um ponteiro para a estrutura SHARE_ACCESS associada ao FileObject. Os drivers devem tratar essa estrutura como opaca.

[in, optional] WritePermission

Um ponteiro para o valor que especifica se o objeto de arquivo tem permissão de gravação. Esse valor será TRUE se o compartilhamento tiver permissão de gravação; caso contrário, será FALSE. Se o valor for FALSE e o chamador tentar obter acesso de leitura exclusivo, a permissão de gravação será rebaixada para FILE_SHARE_READ.

Retornar valor

Nenhum

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

ACCESS_MASK

IoCreateFile