estrutura SHARE_INFO_2 (lmshare.h)

Artigo
03/14/2023

Contém informações sobre o recurso compartilhado, incluindo o nome do recurso, o tipo e as permissões e o número de conexões atuais. Para obter mais informações sobre como controlar o acesso a objetos protegíveis, consulte Controle de Acesso, Privilégios e Objetos Protegíveis.

Sintaxe

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Membros

shi2_netname

Ponteiro para uma cadeia de caracteres Unicode especificando o nome de compartilhamento de um recurso. As chamadas para a função NetShareSetInfo ignoram esse membro.

shi2_type

Uma combinação de valores que especificam o tipo do recurso compartilhado. As chamadas para a função NetShareSetInfo ignoram esse membro.

Um dos valores a seguir pode ser especificado. Você pode isolar esses valores usando o valor STYPE_MASK .

Valor	Significado
STYPE_DISKTREE	Unidade de disco.
STYPE_PRINTQ	Fila de impressão.
STYPE_DEVICE	Dispositivo de comunicação.
STYPE_IPC	Comunicação entre processos (IPC).

Além disso, um ou ambos os valores a seguir podem ser especificados.

Valor	Significado
STYPE_SPECIAL	Compartilhamento especial reservado para comunicação entre processos (IPC$) ou administração remota do servidor (ADMIN$). Também pode se referir a compartilhamentos administrativos como C$, D$, E$e assim por diante. Para obter mais informações, consulte Funções de compartilhamento de rede.
STYPE_TEMPORARY	Um compartilhamento temporário.

shi2_remark

Ponteiro para uma cadeia de caracteres Unicode que contém um comentário opcional sobre o recurso compartilhado.

shi2_permissions

Especifica um valor DWORD que indica as permissões do recurso compartilhado para servidores em execução com segurança em nível de compartilhamento. Um servidor que executa a segurança no nível do usuário ignora esse membro. Esse membro pode ser um ou mais dos valores a seguir. As chamadas para a função NetShareSetInfo ignoram esse membro.

Observe que o Windows não dá suporte à segurança em nível de compartilhamento.

Valor	Significado
ACCESS_READ	Permissão para ler dados de um recurso e, por padrão, executar o recurso.
ACCESS_WRITE	Permissão para gravar dados no recurso.
ACCESS_CREATE	Permissão para criar uma instância do recurso (como um arquivo); os dados podem ser gravados no recurso conforme o recurso é criado.
ACCESS_EXEC	Permissão para executar o recurso.
ACCESS_DELETE	Permissão para excluir o recurso.
ACCESS_ATRIB	Permissão para modificar os atributos do recurso (como a data e a hora em que um arquivo foi modificado pela última vez).
ACCESS_PERM	Permissão para modificar as permissões (ler, gravar, criar, executar e excluir) atribuídas a um recurso para um usuário ou aplicativo.
ACCESS_ALL	Permissão para ler, gravar, criar, executar e excluir recursos e modificar seus atributos e permissões.

shi2_max_uses

Especifica um valor DWORD que indica o número máximo de conexões simultâneas que o recurso compartilhado pode acomodar. O número de conexões será ilimitado se o valor especificado neste membro for –1.

shi2_current_uses

Especifica um valor DWORD que indica o número de conexões atuais com o recurso. As chamadas para a função NetShareSetInfo ignoram esse membro.

shi2_path

Ponteiro para uma cadeia de caracteres Unicode especificando o caminho local para o recurso compartilhado. Para discos, shi2_path é o caminho que está sendo compartilhado. Para filas de impressão, shi2_path é o nome da fila de impressão que está sendo compartilhada. As chamadas para a função NetShareSetInfo ignoram esse membro.

shi2_passwd

Ponteiro para uma cadeia de caracteres Unicode que especifica a senha do compartilhamento quando o servidor está em execução com segurança em nível de compartilhamento. Se o servidor estiver em execução com segurança no nível do usuário, esse membro será ignorado. O membro shi2_passwd não pode ser mais do que SHPWLEN+1 bytes (incluindo um caractere nulo de terminação). As chamadas para a função NetShareSetInfo ignoram esse membro. Observe que o Windows não dá suporte à segurança em nível de compartilhamento.

Requisitos


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

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de compartilhamento de rede