GetOwnerModuleFromTcp6Entry, fonction (iphlpapi.h)

Article
08/24/2023

La fonction GetOwnerModuleFromTcp6Entry récupère les données relatives au module qui a émis la liaison de contexte pour un point de terminaison TCP IPv6 spécifique dans une ligne de table MIB.

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromTcp6Entry(
  [in]      PMIB_TCP6ROW_OWNER_MODULE     pTcpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

Paramètres

[in] pTcpEntry

Pointeur vers une structure de MIB_TCP6ROW_OWNER_MODULE qui contient l’entrée de point de terminaison TCP IPv6 utilisée pour obtenir le module propriétaire.

[in] Class

Une valeur d’énumération TCPIP_OWNER_MODULE_INFO_CLASS qui indique le type de données à obtenir concernant le module propriétaire. L’énumération TCPIP_OWNER_MODULE_INFO_CLASS est définie dans le fichier d’en-tête Iprtrmib.h.

Ce paramètre doit être défini sur TCPIP_OWNER_MODULE_INFO_BASIC.

[out] pBuffer

Pointeur vers une mémoire tampon qui contient une structure TCPIP_OWNER_MODULE_BASIC_INFO avec les données du module propriétaire. Le type de données retournées dans cette mémoire tampon est indiqué par la valeur du paramètre Class .

Les structures suivantes sont utilisées pour les données dans Buffer lorsque Class est défini sur la valeur correspondante.

Valeur d’énumération de classe	Format des données de mémoire tampon
TCPIP_OWNER_MODULE_BASIC_INFO	TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

Taille estimée de la structure retournée dans Mémoire tampon, en octets. Si cette valeur est définie trop petite, ERROR_INSUFFICIENT_BUFFER est retourné par cette fonction, et ce champ contient la taille de structure appropriée.

Valeur retournée

Si l’appel de fonction réussit, la valeur NO_ERROR est retournée.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INSUFFICIENT_BUFFER	Un espace insuffisant a été alloué pour la table. La taille de la table est retournée dans le paramètre pdwSize et doit être utilisée dans un appel ultérieur à cette fonction afin de récupérer la table.
ERROR_INVALID_PARAMETER	Un paramètre est incorrect. Cette valeur est retournée si l’un des paramètres pTcpEntry ou pdwSize a la valeur NULL. Cette valeur est également retournée si le paramètre Class n’est pas égal à TCPIP_OWNER_MODULE_INFO_BASIC.
ERROR_NOT_ENOUGH_MEMORY	La mémoire n'est pas suffisante pour terminer cette opération.
ERROR_NOT_FOUND	L'élément est introuvable. Cette valeur est retournée si le membre dwOwningPid du MIB_TCP6ROW_OWNER_MODULE pointé par le paramètre pTcpEntry était zéro ou introuvable.
ERROR_PARTIAL_COPY	Seule une partie d’une demande a été effectuée.

Notes

Le paramètre Buffer contient non seulement une structure avec des pointeurs vers des données spécifiques, par exemple des pointeurs vers les chaînes sans fin qui contiennent le nom et le chemin du module propriétaire, mais aussi les données elles-mêmes ; il s’agit des chaînes de nom et de chemin d’accès. Par conséquent, lorsque vous calculez la taille de la mémoire tampon, assurez-vous que vous disposez de suffisamment d’espace pour la structure ainsi que pour les données vers lesquelles pointent les membres de la structure.

La résolution des entrées de table TCP en modules propriétaires est une bonne pratique. Dans certains cas, le nom du module propriétaire retourné dans la structure TCPIP_OWNER_MODULE_BASIC_INFO peut être un nom de processus (par exemple, « svchost.exe »), un nom de service (tel que « RPC ») ou un nom de composant (tel que « timer.dll »).

Pour les ordinateurs exécutant Windows Vista ou version ultérieure, les membres pModuleName et pModulePath du TCPIP_OWNER_MODULE_BASIC_INFO récupérés par la fonction GetOwnerModuleFromTcpEntry peuvent pointer vers une chaîne vide pour certaines connexions TCP. Les applications qui démarrent des connexions TCP situées dans le dossier système Windows (C:\Windows\System32, par défaut) sont considérées comme protégées. Si la fonction GetOwnerModuleFromTcpEntry est appelée par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction réussit, mais les membres pModuleName et pModulePath pointent vers la mémoire qui contient une chaîne vide pour les connexions TCP démarrées par les applications protégées.

Pour les ordinateurs exécutant Windows Vista ou version ultérieure, l’accès aux membres pModuleName et pModulePath de la structure TCPIP_OWNER_MODULE_BASIC_INFO est limité par le contrôle de compte d’utilisateur (UAC). Si une application qui appelle cette fonction est exécutée par un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré, cet appel réussit, mais l’accès à ces membres retourne une chaîne vide, sauf si l’application a été marquée dans le fichier manifeste avec un requestedExecutionLevel défini sur requireAdministrator. Si l’application sur Windows Vista ou version ultérieure ne dispose pas de ce fichier manifeste, un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré doit alors exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur d’exécution) pour autoriser l’accès aux membres pModuleName et pModulePath protégés.

Spécifications


Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll

Voir aussi

MIB_TCP6ROW_OWNER_MODULE

TCPIP_OWNER_MODULE_INFO_CLASS

Share via