Usar funções

  • Artigo

As funções de uso do gerenciamento de rede examinam e gerenciam conexões (usos) entre estações de trabalho e servidores. As funções de uso são listadas a seguir.

Função Descrição
NetUseAdd Cria uma conexão entre um computador local e um servidor.
NetUseDel Encerra uma conexão com um recurso compartilhado.
NetUseEnum Lista todas as conexões atuais entre o computador local e os recursos em servidores remotos.
NetUseGetInfo Retorna informações sobre uma conexão com um recurso compartilhado.

 

Essas funções se aplicam somente ao cliente do Bloco de Mensagens do Servidor (Estação de Trabalho do Gerenciador de LAN). A função NetUseGetInfo não dá suporte a compartilhamentos do DFS (Sistema de Arquivos Distribuído). Para recuperar informações de conexão para um recurso compartilhado usando um provedor de rede diferente (WebDAV ou um compartilhamento DFS, por exemplo), use a função WNetGetConnection .

As conexões são diferenciadas das sessões: uma sessão é estabelecida na primeira vez que uma estação de trabalho faz uma conexão com um recurso compartilhado no servidor. Todas as conexões adicionais entre a estação de trabalho e o servidor fazem parte dessa mesma sessão até que a sessão termine. Dois tipos de conexões podem ser feitas: conexões de nome de dispositivo (que só podem ser explícitas) e conexões UNC (convenção de nomenclatura universal) (que podem ser explícitas ou implícitas).

As conexões são feitas por usuário. Uma conexão feita por um usuário é excluída quando esse usuário faz logoff. Por esse motivo, as funções de uso do gerenciamento de rede são locais apenas, pois uma conexão configurada por um usuário remoto não seria acessível a nenhum outro usuário, mesmo o usuário que estava conectado interativamente a esse computador.

A função NetUseAdd estabelece uma conexão explícita entre o computador local e um recurso compartilhado em um servidor redirecionando um nome de dispositivo local para o nome de compartilhamento de um recurso de servidor remoto (\\nomedo sharename\ do servidor). Depois que uma conexão de nome de dispositivo for feita, os usuários ou aplicativos poderão usar o recurso remoto especificando o nome do dispositivo local.

Conexões UNC implícitas são feitas pela função responsável pela conexão. Para estabelecer uma conexão UNC implícita, um aplicativo passa o nome do compartilhamento de um recurso para qualquer função que aceite caminhos UNC. A função aceita o nome UNC e faz uma conexão com o nome de compartilhamento especificado. Todas as solicitações adicionais nessa conexão exigem o nome completo do compartilhamento.

As funções de uso estão disponíveis nos seguintes níveis de informações: