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

Метод IRTC::Configure

  • Статья

Метод Configure отправляет данные конфигурации для отслеживания данных.

Синтаксис

HRESULT STDMETHODCALLTYPE Configure(
  [in]  HBLOB hConfigurationBlob,
  [out] HBLOB hErrorBlob
);

Параметры

hConfigurationBlob [in]

Дескриптор большого двоичного объекта, настроенного вызывающим объектом.

hErrorBlob [out]

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

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

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

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

Код возврата Описание
NMERR_BLOB_NOT_INITIALIZED
 Метод CreateBlob не был вызван.
NMERR_INVALID_BLOB
 Объект, на который указывает , не является БОЛЬШИМ ДВОИЧНЫМ ОБЪЕКТОМ.
NMERR_UPLEVEL_BLOB
 Неправильный номер версии BLOB.
NMERR_BLOB_ENTRY_ALREADY_EXISTS
 Повторяющийся BLOB-объект.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 В большом двоичном объекте конфигурации, заданном параметром hConfigurationBlob , отсутствует запись, необходимая для выполнения этой операции. Просмотрите большой двоичный объект ошибки, возвращенный hErrorBlob , чтобы определить, какая запись не найдена.
NMERR_AMBIGUOUS_SPECIFIER
 Отсутствуют данные владельца BLOB или категории.
NMERR_BLOB_OWNER_NOT_FOUND
 Раздел Владелец BLOB не найден.
NMERR_BLOB_CATEGORY_NOT_FOUND
 Раздел Категория BLOB не найден.
NMERR_UNKNOWN_CATEGORY
 Раздел Категория BLOB найден, но не понят.
NMERR_UNKNOWN_TAG
 Раздел тега BLOB найден, но не понят.
NMERR_BLOB_CONVERSION_ERROR
 Большой двоичный объект поврежден.
NMERR_ILLEGAL_TRIGGER
 Часть триггера большого двоичного объекта повреждена.
NMERR_BLOB_STRING_INVALID
 Строка не заканчивается null.

Комментарии

Этот метод необходимо применить, чтобы перезапустить NPP, которая была запущена, остановлена, но не отключена.

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

Требования

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

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

IRTC

IRTC::Connect

Большие двоичные объекты сетевого монитора