GetOwnerModuleFromTcpEntry, fonction (iphlpapi.h)
La fonction GetOwnerModuleFromTcpEntry récupère les données relatives au module qui a émis la liaison de contexte pour un point de terminaison TCP IPv4 spécifique dans une ligne de table MIB.
Syntaxe
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
);
Paramètres
[in] pTcpEntry
Pointeur vers une structure de MIB_TCPROW_OWNER_MODULE qui contient l’entrée de point de terminaison TCP IPv4 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 d’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, en octets, de la structure retournée dans La mémoire tampon. Si cette valeur est définie trop petite, ERROR_INSUFFICIENT_BUFFER est retourné par cette fonction, et ce champ contient la taille correcte de la mémoire tampon. La taille requise est la taille de la structure correspondante plus un nombre supplémentaire d’octets égal à la longueur des données pointées dans la structure (par exemple, les chaînes de nom et de chemin d’accès).
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 |
|---|---|
|
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. |
|
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. |
|
La mémoire n'est pas suffisante pour terminer cette opération. |
|
Un élément est introuvable. Cette valeur est retournée si le membre dwOwningPid de la structure MIB_TCPROW_OWNER_MODULE pointée vers le paramètre pTcpEntry était zéro ou introuvable. |
|
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, tel que « 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 |