estrutura MIB_UDPROW_OWNER_MODULE (udpmib.h)

Artigo
08/26/2023

A estrutura MIB_UDPROW_OWNER_MODULE contém uma entrada da tabela do ouvinte UDP (Protocolo de Datagrama do Usuário) IPv4 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_UDPROW_OWNER_MODULE {
  DWORD         dwLocalAddr;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDPROW_OWNER_MODULE, *PMIB_UDPROW_OWNER_MODULE;

Membros

dwLocalAddr

Tipo: DWORD

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

Tipo: DWORD

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

dwOwningPid

Tipo: DWORD

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.

liCreateTimestamp

Tipo: LARGE_INTEGER

Uma estrutura FILETIME que indica quando a chamada para a função de associação para o ponto de extremidade UDP ocorreu.

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_UDPTABLE_OWNER_MODULE é retornada por uma chamada para GetExtendedUdpTable com o parâmetro TableClass definido como UDP_TABLE_OWNER_MODULE da enumeração UDP_TABLE_CLASS e do parâmetro ulAf definido como AF_INET. A estrutura MIB_UDPTABLE_OWNER_MODULE contém uma matriz de estruturas MIB_UDPROW_OWNER_MODULE .

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