Compartilhar via


estrutura SHARE_INFO_503 (lmshare.h)

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)

Confira também

NetServerTransportAddEx

NetSessionDel

NetShareAdd

NetShareDelEx

NetShareEnum

NetShareGetInfo

Netsharesetinfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Funções de compartilhamento de rede