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]

BLOB 的句柄。

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，这会设置查询以返回 BLOB 中的每个条目，每次后续调用一个。

指定所有者会将返回的字符串限制为仅该所有者。 类别和标记也存在类似的限制，另外需要注意的是，如果指定了类别，还必须指定所有者，如果指定了标记，则类别 (，因此必须指定所有者) 。

当对 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