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]

指向“类别”部分的指针,用于从中获取字符串。

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_EXISTpRestartKey 参数指向零。

注解

对 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