Метод IDelaydC::Connect

  • Статья

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

Синтаксис

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

Параметры

hInputBlob [in]

Выполните обработку большого двоичного объекта, который указывает сетевой адаптер, к которому выполняется подключение, и сведения о конфигурации этого подключения.

StatusCallbackProc [in]

Адрес функции обратного вызова пользователя, которая используется для получения обновлений состояния, таких как триггеры. Если функция обратного вызова не используется, задайте для этого параметра и параметра UserContextзначение NULL.

UserContext [in]

Значение, передаваемое при вызове функции обратного вызова пользователя. Значением этого параметра обычно является HWND или указатель "this". Если функция обратного вызова не указана, задайте для этого параметра и параметра StatusCallbackProcзначение NULL.

hErrorBlob [out]

Обработка большого двоичного объекта ошибки, содержащего дополнительные сведения об ошибке.

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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

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

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start