TFormer_SetDSParameterValue

Provide Data · String encodings

Definition

Windows: ANSI; Unix: UTF-8

ERRCODE TFormer_SetDSParameterValue(HTFORM pInstance, LPCSTR pszParameterName, LPCSTR pszValue);

Windows only: UTF-16

ERRCODE TFormer_SetDSParameterValueW(HTFORM pInstance, LPCWSTR pszParameterName, LPCWSTR pszValue);

Contract

Specifies the value of a DataSourceParameter.


Use this function to specify a value for a DataSourceParameter. A DataSourceParameter may be defined by the user with TFORMer Designer and can be used to control certain aspects of a DataSource during runtime (e.g. filenames, SQL statement or an ODBC-DSN).

Returns

- ErrOk (0) in case of success, non-zero if an error occurred

Parameters

Parameter / typeDescription
pInstanceHTFORM


The TFORMer instance provided by a previous call to TFormer_Init

pszParameterNameLPCSTR / LPCWSTR


The name of the DataSourceParameter to be set

pszValueLPCSTR / LPCWSTR


The value to be set

Note

Must be called before TFormer_Print, but after TFormer_SetDatasourceName or if a parameter of the active Datasource should be set, after TFormer_SetFormName.

Search documentation

Search in
More scopes
Additional scopes

All contents