Synopsis:

       SMword(vox_chan,prompt_no[,ipf_id])

Arguments:

       vox_chan – The voice channel

       prompt_no -  The prompt number to add to the list of words to play (ranging from 1 upwards)

       [ipf_id]  - The optional IPF number  (ranging from 1 upwards).

Description:      See Index Prompt Files for more information about index prompt file initialisation.      

This function allows for words to be added one at a time to the list of words from the Index Prompt Files to play on the specified vox_chan (with a call to SMplayph()).    

To start a new list of words the function should be called with a prompt number of 0, otherwise the word will be added to the existing list that is being built up.

The prompt_no identifies the index into the IPF file of the prompt to play (starting at 0).     

The optional ipf_id allows a specific IPF_ID to be specified (as defined in the PR.PAR file).       If no ipf_id is specified then the one given in the SMplayph() will be used.    IF an ipf_id is specified then the one given in he SMplayph() will be ignored for this word and the one specified here will be used instead.

Returns:   Returns 0 if successful or a negative error code.