Поделиться через

Функция CreateProtocol

  • Статья

Функция CreateProtocol уведомляет сетевой монитор о наличии определенного средства синтаксического анализа протокола.

Синтаксис

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

Параметры

ProtocolName [in]

Имя протокола, который будет обнаруживать средство синтаксического анализа.

lpEntryPoints [in]

Структура ENTRYPOINTS , содержащая оставшиеся точки входа dll средства синтаксического анализа. Список функций экспорта, на которые ссылается каждая точка входа, см. в разделе Примечания. Точки входа должны быть предоставлены в порядке, указанном в структуре ENTRYPOINTS .

cbEntryPoints [in]

Размер структуры ENTRYPOINTS . Монитор сети предоставляет ENTRYPOINTS_SIZE макрос, который можно использовать для указания размера структуры.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение является дескриптором протокола.

Если функция не работает, возвращаемое значение равно NULL.

Комментарии

Библиотека DLL средства синтаксического анализа вызывает CreateProtocol во время реализации DllMain. Функция CreateProtocol вызывается, когда операционная система загружает библиотеку DLL средства синтаксического анализа в первый раз.

Точки входа, на которые ссылается параметр lpEntryPoints , включают указатели на следующие функции экспорта, которые должны быть предоставлены в указанном здесь порядке.

Для получения информации о См.
Что такое средства синтаксического анализа и как они работают с монитором сети. Средства синтаксического анализа
Реализация DllMain включает пример вызова CreateProtocol в DllMain. Реализация DllMain

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Netmon.h
Библиотека
Nmapi.lib
DLL
Nmapi.dll

См. также раздел

DllMain