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

Метод IESP::Configure

  • Статья

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

Синтаксис

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

Параметры

hConfigurationBlob [in]

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

hErrorBlob [out]

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

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

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

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

Код возврата Описание
NMERR_NOT_CONNECTED
 NPP не подключена к сети.
NMERR_NOT_ESP
 NPP подключена к сети, но не с помощью метода IESP::Connect .
NMERR_CAPTURING
 NPP сообщает о начале сеанса захвата.
NMERR_ILLEGAL_TRIGGER
 Часть триггера большого двоичного объекта конфигурации повреждена.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 В большом двоичном объекте конфигурации, указанном в hConfigurationBlob , отсутствует запись, необходимая для выполнения этой операции. Просмотрите большой двоичный объект ошибки, возвращенный hErrorBlob , чтобы определить, какая запись не найдена.
NMERR_BLOB_CONVERSION_ERROR
 Большой двоичный объект поврежден.
NMERR_BLOB_NOT_INITIALIZED
 Метод CreateBlob не был вызван.
NMERR_INVALID_BLOB
 Объект, на который указывает ссылка, не является БОЛЬШИМ ДВОИЧНЫМ ОБЪЕКТОМ.
NMERR_BLOB_STRING_INVALID
 Строка не заканчивается null.
NMERR_UPLEVEL_BLOB
 Неправильный номер версии БОЛЬШОГО ДВОИЧНОГО ОБЪЕКТА.
NMERR_OUT_OF_MEMORY
 Память не была доступна. Завершите работу окон, чтобы освободить ресурсы.
NMERR_TIMEOUT
 Истекло время ожидания запроса.

Комментарии

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

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

Требования

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