MESSAGE_COMPLETION_CODE

The MESSAGE_COMPLETION_CODE integer tag appears in message taglists returned from the GET_Q_ENTRIES_INFO function. This tag contains a status value for any one of a multitude of fax hardware error codes. A value of 0 means the message was successfully sent or received.

A tool included with NET SatisFAXtion, fb_msg_view.exe, can be used to look up detailed information for specific completion codes.

Type

Max Size

Multiple Allowed

Integer

4 bytes

Yes, one per MESSAGE_HANDLE sub-section

Example:

function GetAllSentMessageStatus()
{
var Tl, Sl;
var Msg = "";

Tl = CAS.New();
CAS.AddTag(Tl,"GET_Q_ENTRIES_INFO","");
CAS.AddTag(Tl,"REGISTERED_NAME","Fred");
CAS.AddTag(Tl,"REGISTERED_PASSWORD","");
CAS.AddTag(Tl,"Q_ID","Q_ID_SENT");

Sl = CAS.CreateSection(Tl,"RESPONSE_INCLUDE_ONLY","");
   CAS.AddTag(Sl,"MESSAGE_COMPLETION_CODE","");
   CAS.AddTag(Sl,"MESSAGE_COMPLETION_CODE_STRING","");
CAS.CloseSection(Sl);

    // Get messages on this already open session
Tl = CAS.Send(Instance,Tl);

if ( CAS.GetTag(Tl,"STATUS_NUM",0) == 0 )
    {
      // The number of messages is in the root of the reply taglist
    QueueCount = CAS.GetTag(Tl,"NUMBER_OF_Q_ENTRIES",0);

      // Each message is in it's own sub-section
    for ( a = 0; a < QueueCount; a++)
      {
      Sl = CAS.OpenSection(Tl,"MESSAGE_HANDLE[" + a + "]");
        Msg += CAS.GetTag(Sl,"MESSAGE_HANDLE",0) + ",";
        Msg += CAS.GetTag(Sl,"MESSAGE_COMPLETION_CODE",0) + ",";
        Msg += CAS.GetTag(Sl,"MESSAGE_COMPLETION_CODE_STRING",0);
        Msg += "\r\n";
      CAS.CloseSection(Sl);
      }
    }
else
    {
      // Return the error
    Msg = CAS.GetTag(Tl,"STATUS",0);
    }

CAS.Delete(Tl);

return(Msg);
}

See Also:

GET_Q_ENTRIES_INFO, MESSAGE_COMPLETION_CODE_STRING