estrutura MIB_UDP6ROW_OWNER_PID (udpmib.h)

Artigo
08/26/2023

A estrutura MIB_UDP6ROW_OWNER_PID contém uma entrada da tabela de ouvintes UDP (User Datagram Protocol) para IPv6 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_UDP6ROW_OWNER_PID {
  UCHAR ucLocalAddr[16];
  DWORD dwLocalScopeId;
  DWORD dwLocalPort;
  DWORD dwOwningPid;
} MIB_UDP6ROW_OWNER_PID, *PMIB_UDP6ROW_OWNER_PID;

Membros

ucLocalAddr[16]

O endereço IPv6 para o ponto de extremidade UDP local. Esse membro é armazenado em uma matriz de caracteres na ordem de bytes de rede.

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

dwLocalScopeId

A ID de escopo do endereço IPv6 do ponto de extremidade UDP no computador local. Esse membro é armazenado na ordem de bytes de rede.

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 uma associação de contexto para esse ponto de extremidade. Se esse valor for definido como 0, as informações para esse ponto de extremidade não ficarão disponíveis.

Comentários

A estrutura MIB_UDP6TABLE_OWNER_PID é retornada por uma chamada para GetExtendedUdpTable com o parâmetro TableClass definido como um UDP_TABLE_OWNER_PID da enumeração UDP_TABLE_CLASS e o parâmetro ulAf definido como AF_INET6. A estrutura MIB_UDP6TABLE_OWNER_PID contém uma matriz de estruturas MIB_UDP6ROW_OWNER_PID .

O membro ucLocalAddr é armazenado em uma matriz de caracteres na ordem de bytes de rede. No Windows Vista e posteriores, as funções RtlIpv6AddressToString ou RtlIpv6AddressToStringEx podem ser usadas para converter o endereço IPv6 no membro ucLocalAddr em uma cadeia de caracteres sem carregar a DLL do Windows Sockets.

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

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_UDP6TABLE_OWNER_PID contém a tabela do ouvinte UDP para IPv6 no computador local. O nome baseia-se na definição dessa tabela no RFC 2454 publicada pelo IETF. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc2454.txt. Esta tabela contém pontos de extremidade UDP para IPv6 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)