%U_GETWNDERR
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
window_error = %U_GETWNDERR([text])
or
xcall U_GETWNDERR([text])
Return value
window_error
The window system error. (^VAL)
Arguments
text
(optional) Returned with the error message text. (a)
Discussion
%U_GETWNDERR returns the error number of the last window error returned as a result of Toolkit calling a Synergy windowing API routine (which it often does when you call a Toolkit routine). For information on window errors, see $ERR_WNDERR.
If a Toolkit routine returns a Toolkit error, %U_GETWNDERR returns the accompanying window error number (not the Toolkit error number) in window_error. (The routine that returned the error returns the number for the Toolkit error.) For example, if you pass the error argument for L_CLASS and Toolkit is unable to create the list class because one already exists with the name you specified, Toolkit returns the Toolkit error number (519) in the error argument for L_CLASS, and it returns the window error number (14) in window_error.
If you pass text, %U_GETWNDERR also returns the text of the window or Toolkit error.
If no Toolkit error has been returned and no window error was returned by the last windowing subroutine call within Toolkit, window_error is returned with 0 and text is returned blank. Note, however, that this function should only be called immediately after a Toolkit routine has signaled that a window error has been trapped. Otherwise, errors that are part of Toolkit’s normal processing may be erroneously returned, or subsequent Toolkit calls to Synergy window API routine may overwrite the error information.
See also
- The $ERR_WNDERR error
- L_CLASS, L_CREATE, and I_LDINP routines for Toolkit error messages