Fonction CreateProtocol

Article
06/13/2023

La fonction CreateProtocol avertit Network Monitor qu’un analyseur de protocole spécifique existe.

Syntaxe

HPROTOCOL WINAPI CreateProtocol(
  _In_ LPSTR         ProtocolName,
  _In_ LPENTRYPOINTS lpEntryPoints,
  _In_ DWORD         cbEntryPoints
);

Paramètres

ProtocolName [in]: Nom du protocole détecté par l’analyseur.
lpEntryPoints [in]: Structure ENTRYPOINTS qui contient les points d’entrée DLL de l’analyseur restants. Consultez Remarques pour obtenir la liste des fonctions d’exportation auxquelles chaque point d’entrée fait référence. Les points d’entrée doivent être fournis dans l’ordre spécifié par la structure ENTRYPOINTS .
cbEntryPoints [in]: Taille de la structure ENTRYPOINTS . Network Monitor fournit une macro ENTRYPOINTS_SIZE que vous pouvez utiliser pour spécifier la taille de la structure.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle du protocole.

Si la fonction échoue, la valeur de retour est NULL.

Notes

La DLL de l’analyseur appelle CreateProtocol pendant son implémentation de DllMain. La fonction CreateProtocol est appelée lorsque le système d’exploitation charge la DLL de l’analyseur pour la première fois.

Les points d’entrée référencés dans le paramètre lpEntryPoints incluent des pointeurs vers les fonctions d’exportation suivantes qui doivent être fournis dans l’ordre présenté ici.

Pour plus d’informations sur	Consultez
Quels sont les analyseurs et comment ils fonctionnent avec le Moniteur réseau.	Analyseurs
L’implémentation de DllMain inclut un exemple d’appel de CreateProtocol dans DllMain.	Implémentation de DllMain

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
Bibliothèque	Nmapi.lib
DLL	Nmapi.dll

Voir aussi

DllMain

Partager via