DatStat Illume 4.5 SDK Class Reference

WebServiceContext.AddParticipant Method

This method will add a new participant to the given participant list.

Overload List

Any collisions that occur using this overload will be returned in the ref parameter collisions.

public SDK_Participant[] AddParticipant(SDK_ParticipantList,Int32,String,String,String,String,Hashtable,Boolean,Boolean,Boolean,Boolean,ref SDK_Participant[]&);

The update parameter dictates what happens if a collision is found for this overload method.

public SDK_Participant[] AddParticipant(SDK_ParticipantList,Int32,String,String,String,String,Hashtable,Boolean,Boolean,Boolean,Boolean,ref SDK_Participant[]&,Boolean);

Remarks

The participant’s email address, firstName, lastName, and customId are passed to the method explicitly. Custom participant data can be provided in the dataHash parameter. For example, if you wanted to provide information on what product the participant purchased from you company, you can add the key/value pair “Product”/”Widget_1.0” to the dataHash and pass that hash into this method.

The lcid is an id of the culture for that participant. If this is not important, simply pass in System.Globalization.CultureInfo.CurrentCulture.LCID. as the lcid value.

The boolean parameter isTest will tell the system if this participant is for testing purposes only.

The boolean parameters lastFirstNameUnique, , and customIdUnique tell the system which of the given system participant values (i.e. email, lastName/firstName, customId) shoud be verified unique.

If successful, this method will return one or more instances of SDK_Participant for the new or updated participants. Note that the participants returned will contain the IDs of the participants for future use.

If there is an error during the operation, an exception will be thrown with an appropriate error message.

See Also

WebServiceContext Class | DatStat.SDK.WebServiceWrappers Namespace