Метод IRTC::Connect
Метод Connect подключает NPP к сети с помощью указанного сетевого адаптера и предоставляет сведения о конфигурации подключения.
Синтаксис
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] LPVOID StatusCallbackProc,
[in] LPVOID FramesCallbackProc,
[in] LPVOID UserContext,
[out] HBLOB hErrorBlob
);
Параметры
-
hInputBlob [in]
-
Выполните обработку большого двоичного объекта, который указывает сетевой адаптер, к которому выполняется подключение, и сведения о конфигурации для этого подключения.
-
StatusCallbackProc [in]
-
Адрес функции обратного вызова состояния пользователя, которая получает обновления состояния, например триггеры. Для этого параметра можно задать значение NULL.
-
FramesCallbackProc [in]
-
Адрес функции обратного вызова кадра пользователя, которая используется для получения обновлений состояния, таких как триггеры. Для этого параметра можно задать значение NULL.
-
UserContext [in]
-
Значение передается при вызове функции обратного вызова состояния и кадра пользователя. Если указаны обе функции обратного вызова, они должны использовать одно и то же значение контекста пользователя. Значением этого параметра обычно является HWND или указатель "this".
-
hErrorBlob [out]
-
Обработка большого двоичного объекта ошибки, содержащего дополнительные сведения об ошибке. Сведения о том, что находится в большом двоичном объекте ошибки, см. в разделе Примечания в нижней части этой статьи.
Возвращаемое значение
Если этот метод выполнен успешно, возвращаемое значение будет NMERR_SUCCESS.
Если метод не удается выполнить, возвращается один из следующих кодов ошибок (включая ошибки, возвращаемые внутренним вызовом IRTC::Configure ):
| Код возврата | Описание |
|---|---|
|
Этот экземпляр COM-объекта NPP уже подключен к сети. |
|
Большой двоичный объект конфигурации поврежден. Эта ошибка возникает при вызове IRTC::Configure . |
|
Входной BLOB-объект, заданный параметром hInputBlob , не имеет записи, необходимой для выполнения этой операции. Эта ошибка может быть вызвана вызовом IRTC::Connect или IRTC::Configure . Просмотрите большой двоичный объект ошибки, возвращенный hErrorBlob , чтобы определить, какая запись не найдена. |
|
Функция CreateBlob не была вызвана. Эта ошибка возникает при вызове IRTC::Configure . |
|
Строка не заканчивается null. Эта ошибка возникает при вызове IRTC::Configure . |
|
Часть триггера входного BLOB-объекта повреждена. Эта ошибка возникает при вызове IRTC::Configure . |
|
Объект, указанный в hInputBlob , не является БОЛЬШИМ ДВОИЧНЫМ ОБЪЕКТОМ. Эта ошибка возникает при вызове IRTC::Configure . |
|
Память, необходимая для выполнения этой операции, недоступна. Эта ошибка возникает при вызове IRTC::Configure . |
|
Истекло время ожидания запроса. Эта ошибка возникает при вызове IRTC::Configure . |
|
Неправильный номер версии большого двоичного объекта, указанного в hInputBlob . Эта ошибка возникает при вызове IRTC::Configure . |
Комментарии
При вызове метода Connect NPP автоматически вызывает метод IRTC::Configure с помощью большого двоичного объекта, предоставленного hInputBlob. Обратите внимание, что все коды ошибок, возвращаемые вызовом IRTC::Configure , передаются обратно и возвращаются вызовом IRTC::Connect .
Этот метод необходимо вызвать, прежде чем можно будет начать запись кадров. Обратите внимание, что при подключении к сети с помощью этого метода необходимо продолжать использовать интерфейс IRTC для записи кадров.
При вызове этой функции необходимо указать функцию обратного вызова состояния или кадра, даже если она выступает только в качестве заполнителя.
Входной BLOB-объект, заданный hInputBlob, можно получить, вызвав методы GetNPPBlobFromUI, GetNPPBlobTable и SelectNPPBlobFromTable .
Большой двоичный объект ошибки, возвращаемый в hErrorBlob , содержит сведения об ошибке, которые разработчик или приложение могут использовать для устранения неполадок. Большой двоичный объект ошибки, возвращаемый hErrorBlob , содержит записи, которые сетевому монитору не удалось понять или найти во входном BLOB-объекте, указанном в hInputBlob. Например, если возвращается NMERR_BLOB_ENTRY_DOES_NOT_EXIST, запись Сетевому монитору не удалось найти, включена в возвращенный BLOB-объект ошибки.
| Сведения о | См. |
|---|---|
| Получение входного большого двоичного объекта, представляющего сетевой адаптер | Выбор сетевой карты |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| DLL |
|