Compartilhar via


estrutura SHARE_INFO_1005 (lmshare.h)

Contém informações sobre o recurso compartilhado.

Sintaxe

typedef struct _SHARE_INFO_1005 {
  DWORD shi1005_flags;
} SHARE_INFO_1005, *PSHARE_INFO_1005, *LPSHARE_INFO_1005;

Membros

shi1005_flags

Uma máscara de bits de sinalizadores que especificam informações sobre o recurso compartilhado.

Valor Significado
SHI1005_FLAGS_DFS
0x0001
O compartilhamento especificado está presente em uma estrutura de árvore dfs. Esse sinalizador não pode ser definido com NetShareSetInfo.
SHI1005_FLAGS_DFS_ROOT
0x0002
O compartilhamento especificado é o volume raiz em uma estrutura de árvore dfs. Esse sinalizador não pode ser definido com NetShareSetInfo.
SHI1005_FLAGS_RESTRICT_EXCLUSIVE_OPENS
0x0100
O compartilhamento especificado não permite que o arquivo exclusivo seja aberto, em que as leituras para um arquivo aberto não são permitidas.
SHI1005_FLAGS_FORCE_SHARED_DELETE
0x0200
Os arquivos compartilhados no compartilhamento especificado podem ser excluídos à força.
SHI1005_FLAGS_ALLOW_NAMESPACE_CACHING
0x0400
Os clientes têm permissão para armazenar em cache o namespace do compartilhamento especificado.
SHI1005_FLAGS_ACCESS_BASED_DIRECTORY_ENUM
0x0800
O servidor filtrará as entradas de diretório com base nas permissões de acesso que o usuário no computador cliente tem para o servidor no qual residem os arquivos. Somente os arquivos para os quais o usuário tem acesso de leitura e diretórios para os quais o usuário tem acesso FILE_LIST_DIRECTORY serão retornados. Se o usuário tiver SeBackupPrivilege, todas as informações disponíveis serão retornadas.

Para obter mais informações sobre acesso a arquivos e diretórios, consulte Segurança de arquivos e direitos de acesso.

Para obter mais informações sobre SeBackupPrivilege, consulte Privilege Constants.

Nota Esse sinalizador só tem suporte em servidores que executam o Windows Server 2003 com SP1 ou posterior.
 
SHI1005_FLAGS_FORCE_LEVELII_OPLOCK
0x1000
Impede modos de cache exclusivos que podem causar atrasos para dados altamente compartilhados somente leitura.
Nota Esse sinalizador só tem suporte em servidores que executam o Windows Server 2008 R2 ou posterior.
 
SHI1005_FLAGS_ENABLE_HASH
0x2000
Habilita a funcionalidade do lado do servidor necessária para o suporte ao cache de pares. Os clientes em conexões de alta latência ou baixa largura de banda podem usar métodos alternativos para recuperar dados de pares, se disponíveis, em vez de enviar solicitações para o servidor. Só há suporte para isso em compartilhamentos configurados para cache manual (CSC_CACHE_MANUAL_REINT).
Nota Esse sinalizador só tem suporte em servidores que executam o Windows Server 2008 R2 ou posterior.
 
SHI1005_FLAGS_ENABLE_CA
0X4000
Habilita a Disponibilidade Contínua em um compartilhamento de cluster. Identificadores abertos em um compartilhamento continuamente disponível podem sobreviver a falhas de rede, bem como falhas de nó de cluster.
Nota Esse sinalizador só pode ser definido em um compartilhamento com escopo em um servidor que atenda às seguintes condições:
  • Ele está sendo executado Windows Server 2012 ou posterior.
  • Ele está em uma configuração de cluster.
  • Ele tem o serviço de função "Serviços para Compartilhamentos Continuamente Disponíveis" instalado.
 
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008 e Windows Server 2003: Não há suporte para esse sinalizador.
 

Os valores de máscara CSC_MASK e CSC_MASK_EXT podem ser usados para aplicar sinalizadores específicos ao CSC (cache do lado do cliente).

Valor Significado
CSC_MASK
0x0030
Fornece uma máscara para os seguintes estados CSC.
CSC_CACHE_MANUAL_REINT 0x0000
A reintegração automática de arquivo por arquivo não é permitida.
CSC_CACHE_AUTO_REINT 0x0010
A reintegração arquivo por arquivo é permitida.
0x0020 CSC_CACHE_VDO
As aberturas de arquivo não precisam ser fluídas.
CSC_CACHE_NONE 0x0030
O CSC está desabilitado para esse compartilhamento.
CSC_MASK_EXT
0x2030
Fornece uma máscara para os seguintes estados e opções de CSC.
CSC_CACHE_MANUAL_REINT 0x0000
A reintegração automática de arquivo por arquivo não é permitida.
CSC_CACHE_AUTO_REINT 0x0010
A reintegração arquivo por arquivo é permitida.
0x0020 CSC_CACHE_VDO
As aberturas de arquivo não precisam ser fluídas.
CSC_CACHE_NONE 0x0030
O CSC está desabilitado para esse compartilhamento.
SHI1005_FLAGS_ENABLE_HASH 0x2000
Habilita a funcionalidade do lado do servidor necessária para o suporte ao cache de pares.

Comentários

Essa estrutura pode ser recuperada chamando a função NetShareGetInfo . Ele pode ser definido chamando a função NetShareSetInfo .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho lmshare.h (inclua Lm.h)

Confira também

NetShareGetInfo

Netsharesetinfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de compartilhamento de rede