estrutura SHARE_INFO_503 (lmshare.h)

Artigo
08/24/2023

Contém informações sobre o recurso compartilhado. Ela é idêntica à estrutura SHARE_INFO_502 , exceto que ela também contém o nome do servidor.

Sintaxe

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Membros

shi503_netname

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

shi503_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 0x00000000	Unidade de disco.
STYPE_PRINTQ 0x00000001	Fila de impressão.
STYPE_DEVICE 0x00000002	Dispositivo de comunicação.
STYPE_IPC 0x00000003	Comunicação entre processos (IPC).

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

Valor	Significado
STYPE_SPECIAL 0x80000000	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 0x40000000	Um compartilhamento temporário.

shi503_remark

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

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

As chamadas para a função NetShareSetInfo ignoram esse membro.

Esse membro pode ser qualquer um dos valores a seguir.

Valor	Significado
ACCESS_READ 0x00000001	Permissão para ler dados de um recurso e, por padrão, executar o recurso.
ACCESS_WRITE 0x00000002	Permissão para gravar dados no recurso.
ACCESS_CREATE 0x00000004	Permissão para criar uma instância do recurso (como um arquivo); os dados podem ser gravados no recurso à medida que o recurso é criado.
ACCESS_EXEC 0x00000008	Permissão para executar o recurso.
ACCESS_DELETE 0x00000010	Permissão para excluir o recurso.
ACCESS_ATRIB 0x00000020	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 0x00000040	Permissão para modificar as permissões (leitura, gravação, criação, execução e exclusão) atribuídas a um recurso para um usuário ou aplicativo.
ACCESS_ALL 0x00008000	Permissão para ler, gravar, criar, executar e excluir recursos e modificar seus atributos e permissões.

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

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

shi503_path

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

shi503_passwd

Um ponteiro para uma cadeia de caracteres Unicode que especifica a senha do compartilhamento (quando o servidor está em execução com segurança no nível do 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 de 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.

shi503_servername

Um ponteiro para uma cadeia de caracteres que especifica o nome DNS ou NetBIOS do servidor remoto no qual reside o recurso compartilhado. Um valor "*" indica nenhum nome de servidor configurado.

shi503_reserved

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

shi503_security_descriptor

Especifica o SECURITY_DESCRIPTOR associado a esse compartilhamento.

Comentários

O servidor remoto especificado no membro shi503_servername deve ter sido associado a um protocolo de transporte usando a função NetServerTransportAddEx . Na chamada para NetServerTransportAddEx, 2 ou 3 devem ter sido especificados para o parâmetro de nível e o valor SVTI2_SCOPED_NAME deve ter sido especificado na estrutura SERVER_TRANSPORT_INFO_2 para o protocolo de transporte.

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)