DtAcceptReply(3Dt)                                DtAcceptReply(3Dt)


       NAME
             DtAcceptReply - accept a Desktop Metaphor reply

       SYNOPSIS
             #include <Dt/Desktop.h>
             int DtAcceptReply(Screen *scrn, Atom queue, Window client,
                   DtReply *reply);

       DESCRIPTION
             The DtAcceptReply function accepts a Desktop Metaphor reply,
             where:

                   scrn  is the Screen pointer

                   queue is the queue name

                   client
                         is the window ID of the sender

                   reply is a pointer to the DtReply structure

             For each client reply, DtReplyHeader, the standard header
             structure, is prefixed to each reply specific structure:

                   DtReplyType rtype;      /* integer including all reply type */
                   unsigned long serial;   /* serial number of related request */
                   unsigned short version; /* version number */
                   int status;             /* reply specific status info */

             The DtReply structure is a union of all structures related to
             each request type, where version can take the values:

                   DT_OPEN_FOLDER           DT_QUERY_FILE_CLASS

                   DT_MOVE_TO_WB            DT_CREATE_FILE_CLASS

                   DT_MOVE_FROM_WB          DT_DELETE_FILE_CLASS

                   DT_GET_DESKTOP_PROPERTY  DT_GET_DESKTOP_PROPERTY
             serial can take the values:

                   DT_BAD_INPUT    some of the input in the request
                                   structure were invalid





                           Copyright 1994 Novell, Inc.               Page 1

      DtAcceptReply(3Dt)                                DtAcceptReply(3Dt)


                  DT_FAILED       the request failed

                  DT_OK           completed successfully

                  DT_DUP          a resource of the specified name already
                                  exists

                  DT_NOENT        the specified resource does not exist

                  and status can take values described in
                  DtEnqueueRequest(3Dt).

                  DtAcceptReply returns a reply structure in response to
                  certain requests, as defined below.

                  DtMoveToWBReply
                        structure includes the following members:
                        DtReplyHeader

                  DtMoveFromWBReply
                        structure includes the following members:
                        DtReplyHeader

                  DtCreateFclassReply
                        structure includes the following members:

                        DtReplyHeader
                        char *file_name;       /* name of the class file */
                        DtAttrs options;          /* options */

                  options may be one of:

                        DT_DUP
                              file name already exists in class database

                        DT_FAILED
                              unable to process the specified file

                        DT_OK success

                  DtDeleteFclassReply
                        structure includes the following member:

                        DtReplyHeader
                        char *file_name;       /* name of the class file */



                          Copyright 1994 Novell, Inc.               Page 2

       DtAcceptReply(3Dt)                                DtAcceptReply(3Dt)


                   DtQueryFclassReply
                         structure includes the following members:

                         DtReplyHeader
                         char *class_name;      /* name of the file class */
                         DtAttrs options;          /* options */

                   DtGetDesktopPropertyReply
                         structure includes the following members:

                         DtReplyHeader
                         char *value;           /* property value */
                         DtAttrs attrs;            /* attributes */

          Return Values
             On success, DtAcceptReply returns 0.

             On failure, DtAcceptReply returns -1.

       REFERENCES
             DtEnqueueRequest(3Dt)



























                           Copyright 1994 Novell, Inc.               Page 3