QBandBuf入力引数によってポイントされるクエリー バンド文字列から、トランザクション、セッション、プロファイルの名前/値ペアを取得します。 クエリー バンド名と値はUNICODE文字セットで取得されます。
FNC_Get_QueryBandPairsUは、FNC_QB_Pair_t構造体を指すポインタを戻します。
FNC_QB_Pair_tはsqltypes_td.hで定義され、次のメンバーを含みます。
| メンバー | 指定内容 |
|---|---|
| QBName | UNICODEのクエリー バンド名。 |
| QBValue | UNICODEのクエリー バンド値。 |
FNC_GetQueryBandPairsUは、戻りの構造体にローカル記憶域を割り当てます。戻されたペアの数がゼロより大きい場合、UDF、UDM、または外部ストアド プロシージャはFNC_freeを呼び出して、終了前に戻りの構造体を解放する必要があります。
CLIv2を使用してSQLを実行する外部ストアド プロシージャは、未処理のCLIv2リクエストが完了するまで、この関数を呼び出すことはできません。