Compartilhar via


Função NPGetConnectionPerformance (npapi.h)

Retorna informações sobre o desempenho esperado de uma conexão usada para acessar um recurso de rede. A solicitação só pode ser para um recurso de rede conectado no momento.

Sintaxe

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Parâmetros

[in] lpRemoteName

Ponteiro para o nome local ou o nome remoto de um recurso conectado.

[out] lpNetConnectInfo

Ponteiro para uma estrutura NETCONNECTINFOSTRUCT , que será preenchida pelo provedor de rede se o provedor tiver uma conexão com o recurso de rede. Todos os outros campos dessa estrutura, exceto o campo cbStructure , são preenchidos com zeros antes que o MPR passe a solicitação para os provedores de rede. Como resultado, o provedor precisa gravar somente em campos para os quais tem informações disponíveis. Além disso, para valores de taxa, um valor de 1 significa que o desempenho é melhor do que pode ser representado na unidade.

As informações retornadas podem ser uma estimativa. Se a rede não puder obter informações sobre o recurso na rede, ela poderá retornar informações sobre o adaptador de rede e seu desempenho associado e, em seguida, definir o campo dwFlags adequadamente.

Valor retornado

Se a função for bem-sucedida, ela deverá retornar WN_SUCCESS. Caso contrário, ele deverá retornar um código de erro, que pode ser um dos seguintes.

Código de retorno Descrição
WN_NOT_CONNECTED
lpRemoteName não é um recurso de rede conectado.
WN_NO_NETWORK
A rede não está presente.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho npapi.h