Partilhar via


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 forma:

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. Esta 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 de usuário com informações sobre conexões persistentes.
WNetConnectionDialog Inicia uma caixa de diálogo de navegação geral para se conectar a recursos de rede.
WNetConnectionDialog1 Inicia uma caixa de diálogo de navegação geral para se conectar a recursos de rede, usando uma estrutura de CONNECTDLGSTRUCT.
WNetDisconnectDialog Inicia uma caixa de diálogo de navegação geral para se desconectar dos recursos da rede.
WNetDisconnectDialog1 Inicia uma caixa de diálogo de navegação geral para se desconectar de recursos de rede, usando uma estruturaDISCDLGSTRUCT.
WNetGetConnection Recupera o nome do recurso de rede associado a um dispositivo local.
WNetGetUniversalName Quando recebe um caminho baseado em unidade para um recurso de rede, retorna uma forma mais universal do nome.
WNetRestoreConnectionW Restaura a conexão com um recurso de rede, solicitando ao usuário, se necessário, um nome e 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.

 

Observação

As funções WNetAddConnection e WNetCancelConnection são suportadas para compatibilidade com o Windows for Workgroups. No entanto, novos aplicativos devem usar WNetAddConnection2 ou WNetAddConnection3e WNetCancelConnection2.

 

Funções de enumeração

Chame as seguintes funções WNet para enumerar recursos de rede.

Função Descrição
WNetCloseEnum Termina uma enumeração de recurso de rede.
WNetEnumResource Continua uma enumeração de recursos de rede iniciados pelo função WNetOpenEnum.
WNetOpenEnum Inicia uma enumeração de recursos de rede.

 

Funções de Informação

Chame as seguintes funções informativas e utilitárias do 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, aquele relatado 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 do usuário

Chame a seguinte função WNet 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 um estrutura de NETRESOURCE para armazenar informações sobre um recurso de rede.