estrutura SHARE_INFO_502 (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, o número de conexões e outras informações pertinentes.

Sintaxe

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Membros

shi502_netname

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

shi502_type

Uma combinação de valores que especificam o tipo de compartilhamento. 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 as funções de compartilhamento de rede.
STYPE_TEMPORARY	Um compartilhamento temporário.

shi502_remark

Ponteiro para uma cadeia de caracteres Unicode especificando um comentário opcional sobre o recurso compartilhado.

shi502_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. Esse membro é ignorado em um servidor que executa a segurança no nível do usuário. Esse membro pode ser qualquer um 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. Para obter mais informações sobre como controlar o acesso a objetos protegíveis, consulte Controle de Acesso, Privilégios e Objetos Protegíveis.

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.

shi502_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.

shi502_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.

shi502_path

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

shi502_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. Observe que o Windows não dá suporte à segurança em nível de compartilhamento.

Esse membro 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.

shi502_reserved

Reservados; deve ser zero. As chamadas para a função NetShareSetInfo ignoram esse membro.

shi502_security_descriptor

Especifica o SECURITY_DESCRIPTOR associado a esse compartilhamento.

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

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de compartilhamento de rede