TranSetParam

  • Article

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.

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: KitlTran.h.

See Also

Adding Support for the XML Grid to a Transport | TranGetXMLParams

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.