Compartilhar via


estrutura SHARE_INFO_2 (lmshare.h)

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

NetShareAdd

NetShareEnum

NetShareGetInfo

Netsharesetinfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de compartilhamento de rede