estrutura MIB_UDPROW_OWNER_PID (udpmib.h)

Artigo
08/26/2023

A estrutura MIB_UDPROW_OWNER_PID contém uma entrada da tabela de ouvintes UDP (User Datagram Protocol) para IPv4 no computador local. A entrada também inclui a ID do processo (PID) que emitiu a chamada para a função de associação para o ponto de extremidade UDP.

Sintaxe

typedef struct _MIB_UDPROW_OWNER_PID {
  DWORD dwLocalAddr;
  DWORD dwLocalPort;
  DWORD dwOwningPid;
} MIB_UDPROW_OWNER_PID, *PMIB_UDPROW_OWNER_PID;

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 na ordem de bytes de rede.

dwOwningPid

O PID do processo que emitiu a chamada para a função de associação para o ponto de extremidade UDP. Esse membro é definido como 0 quando o PID não está disponível.

Comentários

A estrutura MIB_UDPTABLE_OWNER_PID é retornada por uma chamada para GetExtendedUdpTable com o parâmetro TableClass definido como UDP_TABLE_OWNER_PID e o parâmetro ulAf definido como AF_INET. A estrutura MIB_UDPTABLE_OWNER_PID contém uma matriz de estruturas MIB_UDPROW_OWNER_PID .

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 posterior, 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_OWNER_PID contém a tabela do ouvinte UDP para IPv4 no computador local. O nome baseia-se 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 Software Development Kit do Windows (SDK do Windows) (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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Cabeçalho	udpmib.h (inclua Iphlpapi.h)