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]
-
要從中取得字串之 Owner 區段的指標。
-
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 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|