目的
Update Global Variableは、グローバル変数に値を割り当てるサービス関数です。
構造
#include <pxoper.h> PXSTC_Code PX_UpdateGlobalVar(PX_OperatorHandle operator, PX_Name varName, PX_Addr itemBufferAddr, PX_Length itemBufferSize); PX_Count itemIndex,
次のような場合に当てはまります。
パラメータ | 機能 | 指定 |
---|---|---|
itemBufferAddr | 入力 | グローバル変数への割当て値が格納されるバッファのアドレス |
itemBufferSize | 入力 | 項目バッファの値のサイズ |
itemIndex | 入力 | 更新するグローバル変数の項目 itemIndexパラメータは、1から、グローバル変数の作成時に指定された上限までの範囲となります。 |
operator | 入力 | グローバル変数を更新するオペレータ ハンドル |
varName | 入力 | グローバル変数の名前 |
戻りコード
以下のUpdate Global Variable関数のステータス コードは、Teradata PTオペレータ インターフェースによって定義されます。
ステータス コード | 意味 |
---|---|
PXSTC_InvalidArgument | 1つ以上の正しくない入力引数 |
PXSTC_BadHandle | 未定義のオペレータ ハンドル |
PXSTC_LengthError | 更新値の長さが、グローバル変数バッファの長さと一致しない |
PXSTC_NotEnough | グローバル変数のサイズが大きすぎる |
PXSTC_Success | グローバル変数の更新アクセスの成功 |
使用上の注意
Update Global Variable関数を定義する場合の注意事項は、以下を考慮してください。
対象 | 使用上の注意 |
---|---|
ステータス | 関数のステータスがPXSTC_Successの場合は、itemBufferAddrの位置に格納された値が、itemIndexグローバル変数の指定されたvarNameに割り当てられます。 |
関連項目 |