Функция GetStringsFromBlob

Статья
06/13/2023

Функция GetStringsFromBlob использует последовательные вызовы для получения всех строк в указанных диапазонах.

Синтаксис

DWORD GetStringsFromBlob(
  _In_        HBLOB hBlob,
  _In_  const char  *pRequestedOwnerName,
  _In_  const char  *pRequestedCategoryName,
  _In_  const char  *pRequestedTagName,
  _Out_ const char  **ppReturnedOwnerName,
  _Out_ const char  **ppReturnedCategoryName,
  _Out_ const char  **ppReturnedTagName,
  _Out_ const char  **ppReturnedString,
  _Out_       DWORD *pRestartKey
);

Параметры

hBlob [in]: Дескриптор большого двоичного объекта.
pRequestedOwnerName [in]: Указатель на раздел Владелец для получения строки.
pRequestedCategoryName [in]: Указатель на раздел Category для получения строки.
pRequestedTagName [in]: Указатель на тег для запрошенной строки.
ppReturnedOwnerName [out]: Указатель на переменную, указывающую, где будет возвращено имя владельца .
ppReturnedCategoryName [out]: Указатель на переменную, указывающую, где будет возвращено имя категории .
ppReturnedTagName [out]: Указатель на переменную, указывающую, куда будет возвращено имя тега .
ppReturnedString [out]: Указатель на переменную, указывающую, куда будет возвращено имя строки.
pRestartKey [out]: Указатель на переменную, в которой будет указан и возвращен ключ перезапуска.

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

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

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

Если указанное сочетание сведений владельца, категории и тега не существует, возвращаемое значение будет NMERR_BLOB_ENTRY_DOES_NOT_EXIST.

Когда BLOB полностью проходит в пределах первоначально заданных границ, функция возвращает NMERR_BLOB_ENTRY_DOES_NOT_EXIST, а параметр pRestartKey указывает на ноль.

При первоначальном вызове функции GetStringsFromBlob параметр pRestartKey указывает на переменную, содержащую нулевое значение. Параметры pRequested можно использовать только в том случае, если ключ перезапуска равен нулю. В последующих вызовах, когда pRestartKey имеет ненулевое значение, параметры pRequested игнорируются. При первоначальном вызове все могут указывать на значение NULL, которое настраивает запрос на возврат каждой записи в БОЛЬШОМ двоичном объекте( по одной на последующий вызов).

Указание владельца ограничивает возвращаемые строки только этим владельцем. Аналогичное ограничение верно для категорий и тегов, с дополнительным предостережением о том, что если указана категория, также должен быть указан владелец, а если указан тег, необходимо указать категорию (и, следовательно, владельца).

Когда возвращается начальный вызов GetStringsFromBlob , pRestartKey указывает на новое значение, которое необходимо указать при следующем вызове функции, чтобы получить следующее значение.

Требования

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

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

SetStringInBlob
GetBoolFromBlob
GetClassIDFromBlob
GetDwordFromBlob
GetMacAddressFromBlob
GetNetworkInfoFromBlob
GetNPPAddressFilterFromBlob
GetNPPPatternFilterFromBlob
GetNPPTriggerFromBlob
GetStringFromBlob

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