Функция GetStringsFromBlob
Функция 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 [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|