Partilhar via


Usar funções

As funções de uso de gerenciamento de rede examinam e gerenciam conexões (usos) entre estações de trabalho e servidores. As funções de uso estã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.

 

Esta função aplica-se apenas ao cliente Server Message Block (LAN Manager Workstation). A função NetUseGetInfo não suporta partilhas DFS (Distributed File System). 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 distintas 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 de convenção de nomenclatura universal (UNC) (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 de gerenciamento de rede são apenas locais, porque 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çãoNetUseAdd 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 (\\servername\sharename). Depois que uma conexão de nome de dispositivo é feita, os usuários ou aplicativos podem usar o recurso remoto especificando o nome do dispositivo local.

As 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 de 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 outras solicitações nesta conexão exigem o nome completo do compartilhamento.

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