New

 CAS ActiveX Methods

The New method creates an empty taglist, that is ready to accept tags and sections with the AddTag and CreateSection methods.

LONG New()


Parameters:
None

Return Values:
Taglist, that must be deleted when you are done using it, either by calling the Delete method, or by calling the Send method that deletes input taglists. 

0x0000 = Failure (Current CAS implementation only supports 32,000 active taglists)

Example:
function DeleteMessage( MessageHandle)
  {
  var Tl;

  Tl = CAS.New();
  CAS.AddTag(Tl,"DELETE_MESSAGE","");
  CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
  CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
  CAS.AddTag(Tl,"MESSAGE_HANDLE",MessageHandle);

    // The Send method deletes input taglists, so there is no need
    // to call CAS.Delete(Tl) on the input taglist, just the output.

  Tl = CAS.Send(Instance,Tl);
  LastErrorNum = CAS.GetTag(Tl,"STATUS_NUM",0);
  LastErrorStr = CAS.GetTag(Tl,"STATUS",0);
  CAS.Delete(Tl);
  return( LastErrorNum);
  }

See Also:
CAS AddTag, CAS CreateSection, CAS Delete