estrutura MIB_UDPROW (udpmib.h)

Artigo
08/26/2023

A estrutura MIB_UDPROW contém uma entrada da tabela de ouvintes UDP (User Datagram Protocol) para IPv4 no computador local.

Sintaxe

typedef struct _MIB_UDPROW {
  DWORD dwLocalAddr;
  DWORD dwLocalPort;
} MIB_UDPROW, *PMIB_UDPROW;

Membros

dwLocalAddr

O endereço IPv4 do ponto de extremidade UDP no computador local.

Um valor zero indica um ouvinte UDP disposto a aceitar datagramas para qualquer interface IP associada ao computador local.

dwLocalPort

O número da porta do ponto de extremidade UDP no computador local. Esse membro é armazenado em ordem de byte de rede.

Comentários

A função GetUdpTable recupera a tabela do ouvinte UDP IPv4 no computador local e retorna essas informações em uma estrutura MIB_UDPTABLE .

Uma matriz de estruturas MIB_UDPROW estão contidas na estrutura MIB_UDPTABLE .

O membro dwLocalAddr é armazenado como um DWORD no mesmo formato que a estrutura in_addr . Para usar o membro dwLocalAddr , as funções ntohl ou inet_ntoa no Windows Sockets ou funções semelhantes podem ser necessárias. No Windows Vista e posteriores, as funções RtlIpv4AddressToString ou RtlIpv4AddressToStringEx podem ser usadas para converter o endereço IPv4 no membro dwLocalAddr em uma cadeia de caracteres sem carregar a DLL do Windows Sockets.

O membro dwLocalPort está em ordem de byte de rede. Para usar o membro dwLocalPort , as funções ntohs ou inet_ntoa no Windows Sockets ou funções semelhantes podem ser necessárias.

A estrutura MIB_UDPTABLE contém a tabela do ouvinte UDP para IPv4 no computador local. O nome é baseado na definição dessa tabela no RFC 1213 publicada pelo IETF. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc1213.txt. Esta tabela contém pontos de extremidade UDP para IPv4 que foram associados a um endereço. Deve-se observar que um aplicativo pode criar um soquete UDP e associá-lo a um endereço com a única finalidade de enviar um datagrama UDP, sem intenção de receber pacotes usando esse soquete (funcionando como um ouvinte).

No Microsoft Windows Software Development Kit (SDK) lançado para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada. Essa estrutura é definida no arquivo de cabeçalho Udpmib.h , não no arquivo de cabeçalho Iprtrmib.h . Observe que o arquivo de cabeçalho Udpmib.h é incluído automaticamente em Iprtrmib.h, que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Udpmib.h e Iprtrmib.h nunca devem ser usados diretamente.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	udpmib.h (inclua Iphlpapi.h)