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 [仅限桌面应用] |
| 标头 |
|
| 库 |
|
| DLL |
|