estructura MIB_UDP6ROW_OWNER_MODULE (udpmib.h)
La estructura de MIB_UDP6ROW_OWNER_MODULE contiene una entrada de la tabla de escucha del Protocolo de datagramas de usuario (UDP) para IPv6 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_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;
Miembros
ucLocalAddr[16]
Tipo: UCHAR[16]
Dirección IPv6 del punto de conexión UDP en el equipo local. Este miembro se almacena en una matriz de caracteres en orden de bytes de red.
Un valor de cero indica un agente de escucha UDP dispuesto a aceptar datagramas para cualquier interfaz IP asociada al equipo local.
dwLocalScopeId
Tipo: DWORD
Identificador de ámbito de la dirección IPv6 del punto de conexión UDP en el equipo local.
dwLocalPort
Tipo: DWORD
Número de puerto para el punto de conexión UDP local.
dwOwningPid
Tipo: DWORD
PID del proceso que emitió un enlace de contexto para este punto de conexión. Si este valor se establece en 0, la información de este punto de conexión no está disponible.
liCreateTimestamp
Tipo: LARGE_INTEGER
Estructura FILETIME que indica cuándo se produjo la operación de enlace de contexto que creó este punto de conexión.
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_UDP6TABLE_OWNER_MODULE se devuelve mediante una llamada a GetExtendedUdpTable con el parámetro TableClass establecido en un UDP_TABLE_OWNER_MODULE de la enumeración UDP_TABLE_CLASS y el parámetro ulAf establecido en AF_INET6. La estructura MIB_UDP6TABLE_OWNER_MODULE contiene una matriz de estructuras de MIB_UDP6ROW_OWNER_MODULE .
El miembro ucLocalAddr se almacena en una matriz de caracteres en orden de bytes de red. En Windows Vista y versiones posteriores, las funciones RtlIpv6AddressToString o RtlIpv6AddressToStringEx se pueden usar para convertir la dirección IPv6 en el miembro ucLocalAddr en una cadena sin cargar el archivo DLL de Windows Sockets.
El miembro dwLocalScopeId está en orden de bytes de red. Para usar el miembro dwLocalScopeId , pueden ser necesarias las funciones ntohl o inet_ntoa en Windows Sockets o funciones similares.
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_UDP6TABLE_OWNER_MODULE contiene la tabla del agente de escucha UDP para IPv6 en el equipo local. El nombre se basa en la definición de esta tabla en RFC 2454 publicado por IETF. Para obtener más información, vea http://www.ietf.org/rfc/rfc2454.txt. Esta tabla contiene puntos de conexión UDP para IPv6 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) |