Funções WNet
As funções de Rede do Windows fornecem informações e utilitários para gerenciar recursos de rede. As funções de Rede do Windows podem ser agrupadas da seguinte maneira:
Funções de conexão
Chame as seguintes funções de conexão WNet para conectar um dispositivo local a um recurso de rede e cancelar conexões de rede.
| Função | Descrição |
|---|---|
| MultinetGetConnectionPerformance | Retorna informações sobre o desempenho esperado de uma conexão com um recurso de rede. |
| WNetAddConnection | Conecta um dispositivo local a um recurso de rede. (Fornecido para compatibilidade com versões de 16 bits do Windows.) |
| WNetAddConnection2 | Conecta um dispositivo local a um recurso de rede. |
| WNetAddConnection3 | Conecta um dispositivo local a um recurso de rede. Essa função inclui um parâmetro a mais do que a função WNetAddConnection2, um identificador para uma janela que o provedor de rede pode usar como uma janela de proprietário para caixas de diálogo. |
| WNetCancelConnection | Cancela uma conexão de rede. (Fornecido para compatibilidade com versões de 16 bits do Windows.) |
| WNetCancelConnection2 | Cancela uma conexão de rede, fornecendo a capacidade de atualizar o perfil do usuário com informações sobre conexões persistentes. |
| WNetConnectionDialog | Inicia uma caixa de diálogo de navegação geral para se conectar aos recursos de rede. |
| WNetConnectionDialog1 | Inicia uma caixa de diálogo de navegação geral para se conectar aos recursos de rede usando uma estrutura deCONNECTDLGSTRUCT. |
| WNetDisconnectDialog | Inicia uma caixa de diálogo de navegação geral para desconectar-se dos recursos de rede. |
| WNetDisconnectDialog1 | Inicia uma caixa de diálogo de navegação geral para desconectar-se dos recursos de rede, usando uma estruturaDISCDLGSTRUCT. |
| WNetGetConnection | Recupera o nome do recurso de rede associado a um dispositivo local. |
| WNetGetUniversalName | Quando dado um caminho baseado em unidade para um recurso de rede, retorna uma forma mais universal do nome. |
| WNetRestoreConnectionW | Restaura a conexão a um recurso de rede, solicitando ao usuário, se necessário, um nome e uma senha. |
| WNetUseConnection | Conecta um dispositivo local a um recurso de rede; seleciona automaticamente um dispositivo local não utilizado para redirecionar para o recurso de rede. |
Nota
As funçõesWNetAddConnectioneWNetCancelConnection têm suporte para compatibilidade com o Windows for Workgroups. No entanto, novos aplicativos devem usar WNetAddConnection2 ou WNetAddConnection3 e WNetCancelConnection2.
Funções de enumeração
Chame as funções WNet a seguir para enumerar recursos de rede.
Funções de informações
Chame as seguintes funções informativas e de utilitário da WNet para recuperar o provedor de rede e outras informações.
| Função | Descrição |
|---|---|
| WNetGetLastError | Retorna o código de erro mais recente definido por uma função WNet, a relatada por um provedor de rede. |
| WNetGetNetworkInformation | Retorna informações estendidas sobre um provedor de rede específico. |
| WNetGetProviderName | Retorna o nome do provedor para um tipo específico de rede. |
| WNetGetResourceInformation | Retorna o provedor de rede que possui um recurso e obtém informações sobre o tipo de recurso. |
| WNetGetResourceParent | Retorna o pai de um recurso de rede. |
Funções de usuário
Chame a função WNet a seguir para recuperar o nome do usuário associado a um dispositivo local.
| Função | Descrição |
|---|---|
| WNetGetUser | Retorna o nome de usuário padrão atual ou o nome de usuário que estabeleceu a conexão. |
Muitas das funções WNet usam uma estruturaNETRESOURCE para armazenar informações sobre um recurso de rede.