Compartilhar via

Compartilhar funções

  • Artigo

As funções de compartilhamento de gerenciamento de rede controlam os recursos compartilhados. Um recurso compartilhado é um recurso local em um servidor (por exemplo, um diretório de disco, dispositivo de impressão ou pipe nomeado) que pode ser acessado por usuários e aplicativos na rede.

As funções de compartilhamento são listadas a seguir.

Função Descrição
NetShareAdd Compartilha um recurso em um servidor.
NetShareCheck Consulta se um servidor está compartilhando um dispositivo.
NetShareDel Exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor.
NetShareEnum Recupera informações de compartilhamento sobre cada recurso compartilhado em um servidor.
NetShareGetInfo Recupera informações sobre um recurso compartilhado especificado em um servidor.
Netsharesetinfo Define os parâmetros de um recurso compartilhado.

 

Essas funções de compartilhamento se aplicam somente a compartilhamentos em um servidor do Lan Manager (Bloco de Mensagens do Servidor). Essas funções de compartilhamento não dão suporte a compartilhamentos do DFS (Sistema de Arquivos Distribuído). Por exemplo, a função NetShareGetInfo só pode recuperar informações para um recurso de compartilhamento especificado em um servidor SMB. Para recuperar informações para um compartilhamento usando um provedor de rede diferente (WebDAV ou um compartilhamento DFS, por exemplo), use a função WNetGetConnection .

A função NetShareAdd permite que um usuário ou aplicativo compartilhe um recurso de um tipo específico usando o nome de compartilhamento especificado. A função NetShareAdd requer o nome do compartilhamento e o nome do dispositivo local para compartilhar o recurso. Um usuário ou aplicativo deve ter uma conta no servidor para acessar o recurso.

Você também pode especificar um descritor de segurança a ser associado a um compartilhamento. Os descritores de segurança especificam quais usuários têm permissão para acessar arquivos por meio do compartilhamento e com que tipo de acesso. Especifique um SECURITY_DESCRIPTOR com o nível de informações SHARE_INFO_502 ao chamar NetShareAdd ou NetShareSetInfo. O NetShareSetInfo dá suporte ao nível de informações SHARE_INFO_1501 . Para obter mais informações sobre descritores de segurança, consulte Controle de Acesso.

As funções de gerenciamento de rede usam os seguintes nomes especiais de compartilhamento para IPC (comunicação entre processos) e administração remota do servidor:

  • IPC$, reservado para comunicação entre processos
  • ADMIN$, reservado para administração remota
  • A$, B$, C$ (e outros nomes de disco local seguidos de um sinal de dólar), atribuído a dispositivos de disco locais

Para listar todas as conexões feitas a um recurso compartilhado em um servidor ou listar todas as conexões estabelecidas de um computador específico, chame a função NetConnectionEnum . Você pode chamar NetConnectionEnum nos níveis de informações CONNECTION_INFO_0 e CONNECTION_INFO_1 .

As funções de compartilhamento estão disponíveis nos seguintes níveis de informações, embora alguns níveis de compartilhamento sejam aplicáveis apenas a algumas das funções de compartilhamento:

Examine a documentação de uma função de compartilhamento específica para obter detalhes.

Se você estiver programando para o Active Directory, poderá chamar determinados métodos ADSI (Active Directory Service Interface) para obter a mesma funcionalidade que você pode obter chamando as funções de compartilhamento de gerenciamento de rede. Para obter mais informações, consulte IADsFileShare.