TAttachUserData

Description

Warning

This function is obsolete.

On behalf of the telephony object specified by the parameter dn, attaches the User Data structure specified by the parameter user_data to the T-Server information that is related to the call specified by the parameter conn_id.

Parameters

Name	Description
server	Local server handle to the T-Server in question.
dn	Directory number of the telephony object on whose behalf the data is requested to be attached.
conn_id	Connection identifier of the call in question.
user_data	A pointer to the user data that should be attached to the call.

Return Values

Standard (See standard-return-values.)

T-Server is not concerned with the contents of the data structure specified by the parameter user_data. The new data specified by the parameter user_data is added to a call without removing the existing data. As you can see from the table below, new data does not replace existing data. Instead, T-Server adds to the user_data structure, even if it has the same key.

Example of Addition (Attaching) to User_Data

Existing user_data	user_data to Be Added	Result
data1=1234 data2=5678 data3=9012	data3=9999 data4=1212 data5=5555	data1=1234 data2=5678 data3=9012 data3=9999 data4=1212 data5=5555