Media Management System Library Functions      mmsrsptype(3MS)



NAME
     mmsrsptype, mmsgettree, mmsgetstr,  mmsgetattribute,
     mmshandleerrrsp  -  MS  client  functions  for  handling
     responses

SYNOPSIS
     cc [ flag...] file... -lmms [ library...]
     #include 

     int mmsrsptype(void *response);


     mmsparnodet *mmsgettree(void *response);


     char *mmsgetstr(void *response);


     char *mmsgetattribute(void *response, char *name, void **prev);


     int mmshandleerrresponse(void *response, int * class, int * code,
          char **message);


DESCRIPTION
     For these functions, response is the MS response to an  MP
     command sent by the client.


     The mmsrsptype() macro returns the type of  the  response.
     The following is a list of responses:

     MSAPIRSPUNAC         unacceptable response


     MSAPIRSPFINAL         success response


     MSAPIRSPFINALINTR    intermediate response


     MSAPIRSPFINALER     error response


     MSAPIRSPFINALCANC    cancelled response



     The mmsgettree() macro  returns  the  parse  tree  of  the
     response.




SunOS 5.11          Last change: 28 Oct 2008                    1






Media Management System Library Functions      mmsrsptype(3MS)



     The mmsgetstr() macro returns the response string.


     The mmsgetattribute() function takes a response with  name
     values  looking for name, and returning the value associated
     with it. A client can call this function multiple  times  if
     the  response  contains multiple instances of name. When all
     occurrences of name have been found, NUL is returned.


     The  mmshandleerrrsp()  function   processes   an   error
     response  on  behalf  of  the  client.  It returns the error
     class, error code, and the internationalized  error  message
     if one was included.

RETURN VALUES
     Upon  successful  completion,  mmshandleerrrsp()  returns
     MSAPIOK.  If it encounters a processing error, it returns
     an error code indicating the type of error.

ERORS
     These functions will fail if:

     MSAPIEROR          Unable to obtain error class or code.


     MSAPINOTERSP    Response is not an error response.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Uncommitted                 
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     libmms(3LIB),  mmsinit(3MS),  mmssendcmd(3MS),   attri-
     butes(5)








SunOS 5.11          Last change: 28 Oct 2008                    2