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]
-
Category 名が返される場所を指す変数へのポインター。
-
ppReturnedTagName [out]
-
タグ名が返される場所を指す変数へのポインター。
-
ppReturnedString [out]
-
文字列名が返される場所を指す変数へのポインター。
-
pRestartKey [out]
-
再起動キーが指定されて返される変数へのポインター。
戻り値
関数が成功した場合、戻り値はNMERR_SUCCESS。
関数が失敗した場合、戻り値は問題を示す NMERR 値です。
Owner、Category、Tag の情報の指定された組み合わせが存在しない場合、戻り値はNMERR_BLOB_ENTRY_DOES_NOT_EXIST。
BLOB が最初に指定された境界内で完全に走査されると、関数は NMERR_BLOB_ENTRY_DOES_NOT_EXISTを返し、 pRestartKey パラメーターは 0 を指します。
解説
GetStringsFromBlob 関数の最初の呼び出しでは、pRestartKey パラメーターは値 0 を含む変数を指します。 pRequested パラメーターは、再起動キーが 0 の場合にのみ使用できます。 以降の呼び出しでは、 pRestartKey に 0 以外の値がある場合、 pRequested パラメーターは無視されます。 最初の呼び出しでは、すべてが NULL を指す可能性があります。これにより、後続の呼び出しごとに 1 つずつ、BLOB 内のすべてのエントリを返すクエリが設定されます。
所有者を指定すると、返される文字列は、その所有者のみに制限されます。 カテゴリとタグについても同様の制限が当てはまります。カテゴリを指定する場合は所有者も指定する必要があり、タグが指定されている場合はカテゴリ (したがって所有者) を指定する必要があります。
GetStringsFromBlob の最初の呼び出しが返されると、pRestartKey は新しい値を指します。これは、次の値を取得するために関数の次の呼び出しで指定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|