Estrutura NETCONNECTINFOSTRUCT (winnetwk.h)

A estrutura NETCONNECTINFOSTRUCT contém informações sobre o desempenho de uma rede. Ele é usado pela função NPGetConnectionPerformance .

Sintaxe

typedef struct _NETCONNECTINFOSTRUCT {
  DWORD cbStructure;
  DWORD dwFlags;
  DWORD dwSpeed;
  DWORD dwDelay;
  DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT, *LPNETCONNECTINFOSTRUCT;

Membros

cbStructure

O tamanho da estrutura NETCONNECTINFOSTRUCT , em bytes. Isso é preenchido pelo chamador para indicar o tamanho da estrutura passada. O provedor de rede deve deixar esse campo inalterado e pode assumir que a estrutura é grande o suficiente para conter todos os campos até e incluindo dwOptDataSize.

dwFlags

Essa é uma máscara de bits que pode ter um ou mais dos sinalizadores a seguir.

Valor	Significado
WNCON_FORNETCARD	Se definido, as informações retornadas serão para o desempenho do netcard usado para a conexão. Essas informações serão retornadas se as informações sobre a conexão real não estiverem disponíveis. Se não for definido, as informações retornadas serão para a conexão atual com o recurso, com qualquer degradação de roteamento levada em consideração.
WNCON_NOTROUTED	Se definido, a conexão não será tratada como sendo roteada. Em outras palavras, o roteamento não é levado em conta ao estimar o desempenho. Isso significa que o desempenho real pode ser muito menor do que as informações retornadas. Se não estiver definida, a conexão poderá estar passando por roteadores que limitam o desempenho.
WNCON_SLOWLINK	Se definido, a conexão é conhecida em algum momento por ser superior a um meio que normalmente é lento (por exemplo, um modem usando uma linha telefônica de qualidade normal). Os provedores que retornam um valor em dwSpeed não precisam definir esse bit.
WNCON_DYNAMIC	Se definido, algumas das informações retornadas serão recalculadas dinamicamente. Se esse for o caso, a reutilização dessa solicitação na conexão poderá retornar informações diferentes, mais atuais.

dwSpeed

A velocidade da mídia para o recurso de rede em unidades de 100bps. Por exemplo, um link ponto a ponto de 1.200 baud retorna 12.

dwDelay

O atraso introduzido pela rede ao enviar informações, em milissegundos. Em outras palavras, o tempo entre quando a rede começa a enviar dados e a hora em que eles são recebidos. Isso é além de qualquer latência que foi incorporada ao cálculo de dwSpeed, portanto, o valor retornado será zero para acessar a maioria dos recursos.

dwOptDataSize

Uma recomendação para o tamanho dos dados, em bytes, que é enviada com mais eficiência pela rede quando um aplicativo faz uma única solicitação para o recurso de rede. Por exemplo, para um recurso de rede de disco, esse valor pode ser 2048 ou 512 ao gravar um bloco de dados.

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]
Cabeçalho	winnetwk.h