Mercurial > cpython-lru_cache-weakref
diff Doc/api/exceptions.tex @ 24080:15447a5573bd legacy-trunk
Docs for PyErr_SetFromWindowsErrWithFilename() and
PyErr_SetFromWindowsErr().
Fixes SF# 576016, with additional markup.
| author | Thomas Heller <theller@ctypes.org> |
|---|---|
| date | Tue, 02 Jul 2002 15:47:03 +0000 |
| parents | da1645fd9c24 |
| children | e66ced481c77 |
line wrap: on
line diff
--- a/Doc/api/exceptions.tex Tue Jul 02 15:44:36 2002 +0000 +++ b/Doc/api/exceptions.tex Tue Jul 02 15:47:03 2002 +0000 @@ -193,6 +193,29 @@ instance. \end{cfuncdesc} +\begin{cfuncdesc}{PyObject*}{PyErr_SetFromWindowsErr}{int ierr} + This is a convenience function to raise + \exception{PyExc_WindowsError}. If called with \var{ierr} of + \cdata{0}, the error code returned by a call to + \cfunction{GetLastError()} is used instead. It calls the win32 + function \cfunction{FormatMessage()} to retrieve the Windows + description of error code \var{ierr}, then it constructs a tuple object + whose first item is the integer \cdata{ierr} value and whose second + item is the corresponding error message (gotten from + \cfunction{FormatMessage()}), and then calls + \samp{PyErr_SetObject(\var{PyExc_WindowsError}, \var{object})}. + This function always returns \NULL. This function is only available + on Windows. +\end{cfuncdesc} + +\begin{cfuncdesc}{PyObject*}{PyErr_SetFromWindowsErrWithFilename}{int ierr, + char *filename} + Similar to \cfunction{PyErr_SetFromWindowsErr()}, with the + additional behavior that if \var{filename} is not \NULL, it is + passed to the constructor of \exception{WindowsError} as a third + parameter. This function is only available on Windows. +\end{cfuncdesc} + \begin{cfuncdesc}{void}{PyErr_BadInternalCall}{} This is a shorthand for \samp{PyErr_SetString(PyExc_TypeError, \var{message})}, where \var{message} indicates that an internal
