estrutura MIB_UDP6ROW_OWNER_MODULE (udpmib.h)

Artigo
03/09/2024

A estrutura MIB_UDP6ROW_OWNER_MODULE contém uma entrada da tabela de ouvintes UDP (User Datagram Protocol) para IPv6 no computador local. Essa entrada também inclui todos os dados de propriedade disponíveis e 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_MODULE {
  UCHAR         ucLocalAddr[16];
  DWORD         dwLocalScopeId;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDP6ROW_OWNER_MODULE, *PMIB_UDP6ROW_OWNER_MODULE;

Membros

ucLocalAddr[16]

Tipo: UCHAR[16]

O endereço IPv6 do ponto de extremidade UDP no computador 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

Tipo: DWORD

A ID de escopo do endereço IPv6 do ponto de extremidade UDP no computador local.

dwLocalPort

Tipo: DWORD

O número da porta para o ponto de extremidade UDP local.

dwOwningPid

Tipo: DWORD

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.

liCreateTimestamp

Tipo: LARGE_INTEGER

Uma estrutura FILETIME que indica quando ocorreu a operação de associação de contexto que criou esse ponto de extremidade.

SpecificPortBind

Tipo: int

Um valor que indica se uma porta específica foi especificada na última operação de associação de contexto.

dwFlags

Tipo: int

Um conjunto de sinalizadores. Este membro não é usado no momento.

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Tipo: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

Uma matriz de dados opacos que contém informações de propriedade.

Comentários

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

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_MODULE 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)