Función GetOwnerModuleFromUdp6Entry (iphlpapi.h)

  • Artículo

La función GetOwnerModuleFromUdp6Entry recupera datos sobre el módulo que emitió el enlace de contexto para un punto de conexión UDP IPv6 específico en una fila de tabla MIB.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromUdp6Entry(
  [in]      PMIB_UDP6ROW_OWNER_MODULE     pUdpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

Parámetros

[in] pUdpEntry

Puntero a una estructura de MIB_UDP6ROW_OWNER_MODULE que contiene la entrada de punto de conexión UDP IPv6 utilizada para obtener el módulo propietario.

[in] Class

TCPIP_OWNER_MODULE_INFO_CLASS valor de enumeración que indica el tipo de datos que se van a obtener con respecto al módulo propietario.

[out] pBuffer

Búfer que contiene una estructura de TCPIP_OWNER_MODULE_BASIC_INFO con los datos del módulo propietario. El tipo de datos devueltos en este búfer se indica mediante el valor del parámetro Class .

Las estructuras siguientes se usan para los datos de Buffer cuando Class se establece en el valor correspondiente.

Valor de enumeración de clase Formato de datos de búfer
TCPIP_OWNER_MODULE_BASIC_INFO TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

Tamaño estimado, en bytes, de la estructura devuelta en buffer. Si este valor se establece demasiado pequeño, esta función devuelve ERROR_INSUFFICIENT_BUFFER y este campo contendrá el tamaño correcto de la estructura.

Valor devuelto

Si la llamada se realiza correctamente, se devuelve el valor NO_ERROR . De lo contrario, se devuelve el siguiente error.

Código devuelto Descripción
ERROR_INSUFFICIENT_BUFFER
 Se asignó una cantidad insuficiente de espacio para la tabla. El tamaño de la tabla se devuelve en el parámetro pdwSize y se debe usar en una llamada posterior a esta función para recuperar correctamente la tabla.

Comentarios

El parámetro Buffer no solo contiene una estructura con punteros a datos específicos, por ejemplo, punteros a las cadenas terminadas en cero que contienen el nombre y la ruta de acceso del módulo propietario, sino los datos reales; es el nombre y las cadenas de ruta de acceso. Por lo tanto, al calcular el tamaño del búfer, asegúrese de tener suficiente espacio para la estructura, así como los datos a los que apuntan los miembros de la estructura.

La resolución de entradas de tabla UDP para los módulos propietarios es un procedimiento recomendado. En algunos casos, el nombre del módulo propietario devuelto en la estructura TCPIP_OWNER_MODULE_BASIC_INFO puede ser un nombre de proceso, como "svchost.exe", un nombre de servicio, como "RPC" o un nombre de componente, como "timer.dll".

Para los equipos que se ejecutan en Windows Vista o versiones posteriores, el acceso a los miembros pModuleName y pModulePath de la estructura de TCPIP_OWNER_MODULE_BASIC_INFO está limitado por el control de cuentas de usuario (UAC). Si un usuario que inicia sesión como miembro del grupo Administradores que llama a esta función ejecuta esta función, esta llamada se realizará correctamente, pero el acceso a estos miembros devolverá una cadena vacía a menos que la aplicación se haya marcado en el archivo de manifiesto con un valor requestedExecutionLevel establecido en requireAdministrator. Si la aplicación en Windows Vista o posterior carece de este archivo de manifiesto, un usuario que haya iniciado sesión como miembro del grupo Administradores que no sea el administrador integrado debe ejecutar la aplicación en un shell mejorado como administrador integrado (administrador de runas) para tener acceso a los miembros pModuleName y pModulePath protegidos que se van a permitir.

Requisitos

   
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]
Plataforma de destino Windows
Encabezado iphlpapi.h
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll