XmClipboardEndRetrieve — A clipboard function that completes
retrieval of data from the clipboard

     #include <Xm/CutPaste.h>
int XmClipboardEndRetrieve (display, window)
        Display * display;
        Window  window;

     XmClipboardEndRetrieve suspends copying data
incrementally from the clipboard. It tells the clipboard
routines that the application is through copying an item
from the clipboard. Until this function is called, data
items can be retrieved incrementally from the clipboard with
XmClipboardRetrieve.  The act of copying data is started
with the XmClipboardStartRetrieve function.

display   Specifies a pointer to the Display structure that
          was returned in a previous call to XOpenDisplay or

window    Specifies the window ID of a widget that relates
          the application window to the clipboard. The
          widget’s window ID can be obtained with XtWindow.
          The same application instance should pass the same
          window ID to each of the clipboard functions that
          it calls.

          The function was successful.

          The function failed because the clipboard was
          locked by another application. The application can
          continue to call the function again with the same
          parameters until the lock goes away. This gives
          the application the opportunity to ask if the user
          wants to keep trying or to give up on the

     XmClipboardRetrieve(3), XmClipboardStartCopy(3), and