TranSetParam (Compact 2013)
3/26/2014
This function passes a parameter name and value. The kitldll.dll library calls the TranSetParam function for each parameter in the XML string.
To use the XML grid in a custom transport, you must support the TranGetXMLParams function and the TranSetParam function.
Syntax
BOOL TranSetParam(
LPCWSTR strName,
LPCWSTR strValue,
LPWSTR pstrError,
long lErrorStringSize
);
Parameters
- strName
[in] Name of the parameter.
- strValue
[in] Value of the parameter.
- pstrError
[in, out] Pointer to the error string.
- lErrorStringSize
[in] Size of the error string.
Return Value
This function returns TRUE if there is no validation error. If the TranSetParam function returns FALSE, the pstrError parameter points to the error string.
Remarks
The XML grid dialog box allocates memory for the error string. The lErrorStringSize parameter contains the size, including the terminating nul character, allocated for the error string. Do not overwrite the array in reporting an error.
On the transport side, the implementation of the TranSetParam function does not require knowledge of XML.
Requirements
Header |
kitltran.h |