AddAttribute

public SalNumber AddAttribute(SalString sName, SalString sValue)
public SalNumber AddAttribute(SalString sName, SalNumber nValue)
public SalNumber AddAttribute(SalString sName, SalDateTime dValue)
public SalNumber AddAttribute(SalString sName, SalWindowHandle hValue)
public SalNumber AddAttribute(SalString sName, SalBoolean bValue)

The AddAttribute method adds an attribute to the message.

Parameters

Name Description
SalString sName Name of the attribute to add. This name should always be in uppercase.
SalString sValue Value for attribute.

Returns

The return value is the attribute number of the added attribute.

Comments

Using the AddAttribute method it is possible to add multiple attributes with the same name. When later using FindAttribute or GetAttribute method, the first attribute with the specified name will be returned.

To add attributes in a way so that existing attributes with the same name are overwritten, applications should use the SetAttribute method.

Example provided here