Distributed Tuning Interface Guide (v11)

PvSetStringValue() (DTI 関数)

whichData によって指定されるデータ ターゲットに、文字列型の新しい設定値を保存します。

ヘッダー ファイル:config.h(ヘッダー ファイルも参照)

関数が最初に利用可能になるライブラリ:w3dbav75.dll(Windows)、libpsqldti.so(Linux)(リンク ライブラリも参照)

構文

BTI_SINT PvSetStringValue( 
	BTI_LONG           hConnection, 
	BTI_ULONG          settingID, 
	BTI_CHAR_PTR       newValue, 
	BTI_SINT           whichData); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数) 関数によって取得されます。
In
settingID
設定の一意な識別子。設定の一覧は、PvGetSettingList() (DTI 関数) から取得できます。
In
newValue
設定される文字列値。
In
whichData
どちらの値が設定されるかを示すフラグ。
PVDATA_CURRENT は現在値を設定します。
PVDATA_PERSISTENT は不変値を設定します。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_INVALID_DATA_TYPE
設定は文字列型の設定ではありません。
P_E_FAIL
その他の理由により失敗しました。

備考

設定によっては、セミコロン(;)で区切られた複数の文字列を取ることがあります。

以下の前提条件を満たす必要があります。

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetCategoryList() (DTI 関数)
PvGetSettingList() (DTI 関数)
PvGetStringType() (DTI 関数)
PvGetStringValue() (DTI 関数)
PvIsSettingAvailable() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvSetSelectionValue() (DTI 関数)

PvStart() (DTI 関数)