Partilhar via

Função MultinetGetConnectionPerformanceA (winnetwk.h)

A função MultinetGetConnectionPerformance retorna informações sobre o desempenho esperado de uma conexão usada para acessar um recurso de rede.

Sintaxe

DWORD MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

Parâmetros

[in] lpNetResource

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]
da Plataforma de Destino Windows
cabeçalho winnetwk.h
biblioteca Mpr.lib
de DLL Mpr.dll

Consulte também

NETCONNECTINFOSTRUCT

NETRESOURCE

Visão geral WNet (Rede windows)

funções de rede do Windows

  • Last updated on