Um ponteiro para uma estrutura NETRESOURCE que especifica o recurso de rede. Os membros a seguir têm significados específicos neste contexto.
Membro
Significado
lpLocalName
Um ponteiro para um buffer que especifica um dispositivo local, como "F:" ou "LPT1", que é redirecionado para um recurso de rede a ser consultado.
Se esse membro estiver NULL ou uma cadeia de caracteres vazia, o recurso de rede será especificado no membro lpRemoteName. Se esse sinalizador especificar um dispositivo local, lpRemoteName será ignorado.
lpRemoteName
Um ponteiro para um recurso de rede a ser consultado. No momento, o recurso deve ter uma conexão estabelecida. Por exemplo, se o recurso for um arquivo em um servidor de arquivos, ter o arquivo aberto garantirá a conexão.
lpProvider
Normalmente definido como NULL, mas pode ser um ponteiro para o proprietário (provedor) do recurso se a rede na qual o recurso reside for conhecida.
Se o lpProvider membro não for NULL, o sistema tentará retornar informações apenas sobre a rede nomeada.
[out] lpNetConnectInfoStruct
Um ponteiro para a estrutura NETCONNECTINFOSTRUCT que recebe os dados.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será NO_ERROR.
Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.
Código de retorno
Descrição
ERROR_NOT_SUPPORTED
O recurso de rede não fornece essas informações.
ERROR_NOT_CONNECTED
O lpLocalName membro da estrutura NETRESOURCE apontado pelo parâmetro lpNetResource não especifica um dispositivo redirecionado ou o membro lpRemoteName não especifica o nome de um recurso conectado no momento.
ERROR_NO_NET_OR_BAD_PATH
Não foi possível concluir a operação porque um componente de rede não foi iniciado ou porque o nome do recurso especificado não foi reconhecido.
ERROR_BAD_DEVICE
O dispositivo local especificado pelo membro lpLocalName é inválido.
ERROR_BAD_NET_NAME
O nome da rede não pode ser encontrado. Esse erro será retornado se o lpLocalName membro da estrutura NETRESOURCE apontado pelo parâmetro lpNetResource foi NULL e o lpRemoteName membro da estrutura NETRESOURCE apontada pelo lpNetResource também era ou NULL ou não podia ser reconhecido por nenhuma rede.
ERROR_INVALID_ADDRESS
Uma tentativa de acessar um endereço inválido. Esse erro será retornado se os parâmetros lpNetResource ou lpNetConnectInfoStruct foram NULL.
ERROR_INVALID_PARAMETER
Um parâmetro inválido foi passado. Esse erro será retornado se o parâmetro lpNetConnectInfoStruct não apontar para uma estrutura NETCONNECTINFOSTRUCT na qual o membro cbStructure é preenchido com o tamanho da estrutura adequado.
ERROR_NO_NETWORK
A rede não está disponível.
ERROR_EXTENDED_ERROR
Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame WNetGetLastError.
Observações
A função MultinetGetConnectionPerformance retorna as informações em uma estrutura NETCONNECTINFOSTRUCT .
As informações retornadas pela função MultinetGetConnectionPerformance é apenas uma estimativa. O tráfego de rede e o roteamento podem afetar a precisão dos resultados retornados.
Observe que a função MultinetGetConnectionPerformance pode ser usada apenas para solicitar informações para um dispositivo local redirecionado para um recurso de rede ou para um recurso de rede ao qual há atualmente uma conexão.
Se um caminho UNC for especificado no lpRemoteName membro da estrutura NETRESOURCE apontada pelo parâmetro lpNetResource, o membro lpRemoteName deve ser um nome de diretório, não um nome de arquivo.
Uma maneira típica de usar essa função seria abrir um arquivo em um servidor de rede (o que garantiria que haja uma conexão com o arquivo), chamar essa função e usar os resultados para tomar decisões sobre como gerenciar a E/S do arquivo. Por exemplo, você pode decidir se deve ler todo o arquivo em um arquivo temporário no cliente ou acessar diretamente o arquivo no servidor.
Nota
O cabeçalho winnetwk.h define MultinetGetConnectionPerformance como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito
Valor
de cliente com suporte mínimo
Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo
Windows 2000 Server [somente aplicativos da área de trabalho]