Метод IESP::Connect

Статья
06/13/2023

Метод Connect подключает NPP к сети с помощью указанного сетевого адаптера и предоставляет сведения о конфигурации подключения.

Синтаксис

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB hInputBlob,
  [in]  DWORD StatusCallbackProc,
  [in]  DWORD UserContext,
  [out] HBLOB hErrorBlob
);

Параметры

hInputBlob [in]: Обработка большого двоичного объекта, который указывает сетевой адаптер, к которому подключается NPP, и сведения о конфигурации для этого подключения.
StatusCallbackProc [in]: Адрес функции обратного вызова пользователя, которая получает обновления состояния, такие как триггеры. Если функция обратного вызова не используется, задайте для этого параметра и параметра UserContextзначение NULL.
UserContext [in]: Значение, передаваемое при вызове функции обратного вызова пользователя. Значением этого параметра обычно является HWND или указатель "this". Если функция обратного вызова не указана, задайте для этого параметра и параметра StatusCallbackProcзначение NULL.
hErrorBlob [out]: Обработка большого двоичного объекта ошибки, содержащего дополнительные сведения об ошибке.

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

Если метод выполнен успешно, возвращаемое значение будет NMERR_SUCCESS.

Если метод не удается выполнить, возвращается один из следующих кодов ошибок (включая ошибки, возвращаемые внутренним вызовом IESP::Configure ):

Код возврата	Описание
NMERR_ALREADY_CONNECTED	Этот экземпляр COM-объекта NPP уже подключен к сети.
NMERR_BLOB_CONVERSION_ERROR	Большой двоичный объект конфигурации поврежден. Эта ошибка возникает при вызове IESP::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	Входной BLOB-объект, заданный параметром hInputBlob , не имеет записи, необходимой для выполнения этой операции. Эта ошибка может быть вызвана вызовом IESP::Connect или IESP::Configure . Просмотрите большой двоичный объект ошибки, возвращенный hErrorBlob , чтобы определить, какая запись не найдена.
NMERR_BLOB_NOT_INITIALIZED	Функция CreateBlob не была вызвана. Эта ошибка возникает при вызове IESP::Configure .
NMERR_BLOB_STRING_INVALID	Строка не заканчивается null. Эта ошибка возникает при вызове IESP::Configure .
NMERR_ILLEGAL_TRIGGER	Часть триггера входного BLOB-объекта повреждена. Эта ошибка возникает при вызове IESP::Configure .
NMERR_INVALID_BLOB	Объект, указанный в hInputBlob , не является БОЛЬШИМ ДВОИЧНЫМ ОБЪЕКТОМ. Эта ошибка возникает при вызове IESP::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	Каталог записи по умолчанию не задан в реестре. Используйте следующий путь, чтобы задать каталог записи. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	Память, необходимая для выполнения этой операции, недоступна. Эта ошибка возникает при вызове IESP::Configure .
NMERR_TIMEOUT	Истекло время ожидания запроса. Эта ошибка возникает при вызове IESP::Configure .
NMERR_UPLEVEL_BLOB	Неправильный номер версии большого двоичного объекта, указанного в hInputBlob . Эта ошибка возникает при вызове IESP::Configure .

При вызове метода Connect монитор сети автоматически вызывает IESP::Configure с помощью большого двоичного объекта, предоставленного параметром hInputBlob . Обратите внимание, что все коды ошибок, возвращаемые вызовом IESP::Configure , передаются обратно и возвращаются вызовом IESP::Connect .

Этот метод необходимо вызвать, прежде чем можно будет начать запись кадров. Обратите внимание, что при подключении к сети с помощью этого метода необходимо продолжать использовать интерфейс IESP для записи кадров.

Входной BLOB-объект, заданный hInputBlob, можно получить, вызвав Методы GetNPPBlobFromUI, GetNPPBlobTable и SelectNPPBlobFromTable.

Большой двоичный объект ошибки, возвращаемый hErrorBlob , содержит записи, которые сетевому монитору не удалось понять или найти во входном BLOB-объекте, указанном в hInputBlob. Возвращаемый BLOB-объект ошибки содержит сведения об ошибке, которые приложение может использовать для устранения неполадок. Например, если возвращается NMERR_BLOB_ENTRY_DOES_NOT_EXIST, запись, которую не удалось найти сетевому монитору, будет включена в возвращенный BLOB-объект ошибки.

Сведения о	См.
Получение входного большого двоичного объекта, представляющего сетевой адаптер	Выбор сетевой карты

Требования

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

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

IESP
IESP::Configure
IESP::D isconnect
IESP::Start

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