Share via

Функция GetNPPBlobTable

  • Статья

Функция GetNPPBlobTable извлекает таблицу NPP BLOB, представляющую регистр сетевых адаптеров на локальном компьютере.

Синтаксис

DWORD GetNPPBlobTable(
  _In_  HBLOB       hFilterBlob,
  _Out_ PBLOB_TABLE *ppBlobTable
);

Параметры

hFilterBlob [in]

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

ppBlobTable [out]

Указатель на структуру BLOB_TABLE , содержащую по крайней мере один указатель BLOB.

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

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

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

Код возврата Описание
NMERR_NO_NPP_DLL
 Библиотеки DLL в каталоге NPP не найдены.
NMERR_NO_VALID_NPP_DLLS
 Ни одна из библиотек DLL в каталоге NPP не была допустимой библиотекой DLL NPP.
NMERR_NO_MATCHING_NPPS
 Большие двоичные объекты NPP были обнаружены, но ни один из них не прошел проверку фильтра.
NMERR_OUT_OF_MEMOR
 Сетевому монитору не удалось выделить память.

Комментарии

Большой двоичный объект с именем hFilterBlob также может быть специальным BLOB-объектом.

Если для флага BLOB-объекта фильтра задано значение TRUE, то возвращаемая таблица BLOB также может содержать специальные BLOB-объекты .

Если большой двоичный объект с именем hFilterBlob является специальным BLOB-объектом, пользовательский интерфейс сетевого монитора попытается обработать его. Например, предположим, что предыдущий вызов возвращает специальный большой двоичный объект из удаленного NPP. Приложение вставляет необходимый тег MACHINE_NAME. Затем средство поиска передает этот большой двоичный объект удаленному NPP, который затем возвращает таблицу больших двоичных объектов NPP, связанных с именем компьютера.

Чтобы уничтожить все возвращенные большие двоичные объекты и таблицу BLOB, вызывающий объект отвечает за вызов функции DestroyBlob .

Требования

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