Compartir a través de

Función CreateProtocol

  • Artículo

La función CreateProtocol notifica a Network Monitor que existe un analizador de protocolo específico.

Sintaxis

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

Parámetros

ProtocolName [in]

Nombre del protocolo que detectará el analizador.

lpEntryPoints [in]

Estructura ENTRYPOINTS que contiene el resto de puntos de entrada dll del analizador. Vea Comentarios para obtener una lista de las funciones de exportación a las que hace referencia cada punto de entrada. Los puntos de entrada deben proporcionarse en el orden en que especifica la estructura ENTRYPOINTS .

cbEntryPoints [in]

Tamaño de la estructura ENTRYPOINTS . Network Monitor proporciona una macro ENTRYPOINTS_SIZE que puede usar para especificar el tamaño de la estructura.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el protocolo.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Observaciones

El archivo DLL del analizador llama a CreateProtocol durante su implementación de DllMain. Se llama a la función CreateProtocol cuando el sistema operativo carga el archivo DLL del analizador por primera vez.

Los puntos de entrada a los que se hace referencia en el parámetro lpEntryPoints incluyen punteros a las siguientes funciones de exportación que se deben proporcionar en el orden presentado aquí.

Para obtener información acerca de Vea
Qué son los analizadores y cómo funcionan con Network Monitor. Analizadores
Cómo implementar DllMain incluye un ejemplo de llamada a CreateProtocol en DllMain. Implementación de DllMain

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Netmon.h
Biblioteca
Nmapi.lib
Archivo DLL
Nmapi.dll

Vea también

DllMain