Función GetOwnerModuleFromTcpEntry (iphlpapi.h)
La función GetOwnerModuleFromTcpEntry recupera datos sobre el módulo que emitió el enlace de contexto para un punto de conexión TCP IPv4 específico en una fila de tabla MIB.
Sintaxis
IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromTcpEntry(
[in] PMIB_TCPROW_OWNER_MODULE pTcpEntry,
[in] TCPIP_OWNER_MODULE_INFO_CLASS Class,
[out] PVOID pBuffer,
[in, out] PDWORD pdwSize
);
Parámetros
[in] pTcpEntry
Puntero a una estructura de MIB_TCPROW_OWNER_MODULE que contiene la entrada de punto de conexión TCP IPv4 utilizada para obtener el módulo propietario.
[in] Class
Valor de enumeración TCPIP_OWNER_MODULE_INFO_CLASS que indica el tipo de datos que se van a obtener con respecto al módulo propietario. La enumeración TCPIP_OWNER_MODULE_INFO_CLASS se define en el archivo de encabezado Iprtrmib.h .
Este parámetro debe establecerse en TCPIP_OWNER_MODULE_INFO_BASIC.
[out] pBuffer
Puntero a un búfer que contiene una estructura 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 del búfer. El tamaño necesario es el tamaño de la estructura correspondiente más un número adicional de bytes igual a la longitud de los datos a los que apunta la estructura (por ejemplo, el nombre y las cadenas de ruta de acceso).
Valor devuelto
Si la llamada de función se realiza correctamente, se devuelve el valor NO_ERROR .
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Se asignó espacio insuficiente 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. |
|
Un parámetro es incorrecto. Este valor se devuelve si cualquiera de los parámetros pTcpEntry o pdwSize son NULL. Este valor también se devuelve si el parámetro Class no es igual a TCPIP_OWNER_MODULE_INFO_BASIC. |
|
Memoria insuficiente para completar la operación. |
|
No se encontró ningún elemento. Este valor se devuelve si el miembro dwOwningPid de la estructura MIB_TCPROW_OWNER_MODULE a la que apunta el parámetro pTcpEntry era cero o no se encontró. |
|
Solo se completó parte de una solicitud. |
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 TCP 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".
En el caso de los equipos que se ejecutan en Windows Vista o versiones posteriores, los miembros pModuleName y pModulePath del TCPIP_OWNER_MODULE_BASIC_INFO recuperados por la función GetOwnerModuleFromTcpEntry pueden apuntar a una cadena vacía para algunas conexiones TCP. Las aplicaciones que inician conexiones TCP ubicadas en la carpeta del sistema de Windows (C:\Windows\System32, de forma predeterminada) se consideran protegidas. Si un usuario llama a la función GetOwnerModuleFromTcpEntry que no es miembro del grupo Administradores, la llamada de función se realizará correctamente, pero los miembros pModuleName y pModulePath apuntarán a la memoria que contiene una cadena vacía para las conexiones TCP iniciadas por aplicaciones protegidas.
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 |