estructura MIB_UDPROW_OWNER_MODULE (udpmib.h)
La estructura de MIB_UDPROW_OWNER_MODULE contiene una entrada de la tabla de escucha del Protocolo de datagramas de usuario (UDP) IPv4 en el equipo local. Esta entrada también incluye los datos de propiedad disponibles y el identificador de proceso (PID) que emitió la llamada a la función de enlace para el punto de conexión UDP.
Sintaxis
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;
Miembros
dwLocalAddr
Tipo: DWORD
Dirección IPv4 del punto de conexión UDP en el equipo local.
Un valor de cero indica un agente de escucha UDP dispuesto a aceptar datagramas para cualquier interfaz IP asociada al equipo local.
dwLocalPort
Tipo: DWORD
Número de puerto del punto de conexión UDP en el equipo local. Este miembro se almacena en orden de bytes de red.
dwOwningPid
Tipo: DWORD
PID del proceso que emitió la llamada a la función de enlace para el punto de conexión UDP. Este miembro se establece en 0 cuando el PID no está disponible.
liCreateTimestamp
Tipo: LARGE_INTEGER
Estructura FILETIME que indica cuándo se produjo la llamada a la función de enlace para el punto de conexión UDP.
SpecificPortBind
Tipo: int
Valor que indica si se especificó un puerto específico en la última operación de enlace de contexto.
dwFlags
Tipo: int
Un conjunto de marcas. Este miembro no se usa actualmente.
OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]
Tipo: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]
Matriz de datos opacos que contiene información de propiedad.
Comentarios
La estructura MIB_UDPTABLE_OWNER_MODULE se devuelve mediante una llamada a GetExtendedUdpTable con el parámetro TableClass establecido en UDP_TABLE_OWNER_MODULE de la enumeración UDP_TABLE_CLASS y el parámetro ulAf establecido en AF_INET. La estructura MIB_UDPTABLE_OWNER_MODULE contiene una matriz de estructuras de MIB_UDPROW_OWNER_MODULE .
El miembro dwLocalAddr se almacena como DWORD en el mismo formato que la estructura in_addr . Para usar el miembro dwLocalAddr , pueden ser necesarias las funciones ntohl o inet_ntoa en Windows Sockets o funciones similares. En Windows Vista y versiones posteriores, las funciones RtlIpv4AddressToString o RtlIpv4AddressToStringEx se pueden usar para convertir la dirección IPv4 en el miembro dwLocalAddr en una cadena sin cargar el archivo DLL de Windows Sockets.
El miembro dwLocalPort está en orden de bytes de red. Para usar el miembro dwLocalPort , pueden ser necesarias las funciones ntohs o inet_ntoa en Windows Sockets o funciones similares.
La estructura de MIB_UDPTABLE_OWNER_MODULE contiene la tabla del agente de escucha UDP para IPv4 en el equipo local. El nombre se basa en la definición de esta tabla en RFC 1213 publicada por el IETF. Para obtener más información, vea http://www.ietf.org/rfc/rfc1213.txt. Esta tabla contiene puntos de conexión UDP para IPv4 que se han enlazado a una dirección. Debe tenerse en cuenta que una aplicación puede crear un socket UDP y enlazarlo a una dirección para el único propósito de enviar un datagrama UDP, sin intención de recibir paquetes mediante este socket (funciona como agente de escucha).
En Microsoft Kit de desarrollo de software de Windows (SDK) publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado. Esta estructura se define en el archivo de encabezado Udpmib.h , no en el archivo de encabezado Iprtrmib.h . Tenga en cuenta que el archivo de encabezado Udpmib.h se incluye automáticamente en Iprtrmib.h, que se incluye automáticamente en el archivo de encabezado Iphlpapi.h . Los archivos de encabezado Udpmib.h e Iprtrmib.h nunca deben usarse directamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Encabezado | udpmib.h (include Iphlpapi.h) |