Функция CreateHandoffTable

Функция CreateHandoffTable создает таблицу передачи , содержащую сведения о наборе передач, хранящиеся в INI-файле средства синтаксического анализа.

Синтаксис

DWORD WINAPI CreateHandoffTable(
  _In_  LPSTR          secName,
  _In_  LPSTR          iniFile,
  _Out_ LPHANDOFFTABLE *hTable,
  _In_  DWORD          nMaxProtocolEntries,
  _In_  DWORD          base
);

Параметры

secName [in]

Строка, указывающая раздел INI-файла, в котором находятся сведения о наборе передач.

iniFile [in]

Строка, содержащая имя INI-файла средства синтаксического анализа.

hTable [out]

Обработка структуры HANDOFFTABLE , созданной и поддерживаемой монитором сети.

nMaxProtocolEntries [in]

Число, указывающее максимальное количество записей, которые может обработать таблица передачи.

base [in]

Числовая база чисел набора передачи, хранящихся в INI-файле.

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

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

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

Комментарии

Таблица передачи, созданная монитором сети, основана на информации, предоставленной в ini средства синтаксического анализа. Затем дескриптор, возвращенный в таблицу передачи, можно использовать для получения дескриптора для одного из протоколов, включенных в таблицу. Чтобы получить дескриптор одного из этих протоколов, вызовите Метод GetProtocolFromTable.

Обратите внимание, что приложение средства синтаксического анализа никогда не обращается к структуре HANDOFFTABLE напрямую. Эта структура создается и поддерживается монитором сети.

Требования

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

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

GetProtocolFromTable

HANDOFFTABLE