Distributed Tuning Interface Guide (v11)

PvSetSelectionValue() (DTI 関数)

whichData によって指定されるデータ ターゲットに、選択タイプの新しい設定値を保存します。

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

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

構文

BTI_SINT PvSetSelectionValue( 
	BTI_LONG           hConnection, 
	BTI_ULONG          settingID, 
	BTI_ULONG          numItems, 
	BTI_LONG_PTR       pNewValue, 
	BTI_SINT           whichData); 

引数

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

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_INVALID_DATA_TYPE
設定は選択タイプの設定ではありません。
P_E_INVALID_SELECTION
少なくとも選択項目の 1 つが無効です。
P_E_FAIL
その他の理由により失敗しました。

備考

この関数は単一選択と複数選択の両方のデータ タイプを使った作業に使用します。単一選択の項目に対して複数の項目を設定した場合は、最初の値が使用されます。

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

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetCategoryList() (DTI 関数)
PvGetSettingList() (DTI 関数)
PvGetSelectionValue() (DTI 関数)
PvGetSelectionString() (DTI 関数)
PvGetAllPossibleSelections() (DTI 関数)
PvCountSelectionItems() (DTI 関数)
PvIsSettingAvailable() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvSetLongValue() (DTI 関数)

PvSetStringValue() (DTI 関数)