598.md at [8e6bc11be5]

Login

File tip/598.md artifact 54ecfbf6a8 part of check-in 8e6bc11be5


# TIP 598: export TclWinConvertError
	Author:         Jan Nijtmans <[email protected]>
	State:          Final
	Type:           Project
	Vote:           Done
	Tcl-Version:    8.7
	Tcl-Branch:     rfe-800716
	Vote-Summary:	Accepted 3/0/5
	Votes-For:	JN, KW, KK
	Votes-Against:	none
	Votes-Present:	AK, DP, FV, MC, SL
-----
# Abstract

This TIP proposes to export the current win32-specific
functions `TclWinConvertError()` and `TclWinConvertWSAError()`
under the new name `Tcl_WinConvertError()`.

# Specification

Introduce a new win32-specific API:

* `void Tcl_WinConvertError(unsigned errCode)`

This function can handle both normal win32 errors
and WSA errors, so it's a full replacement
for both `TclWinConvertError()` and `TclWinConvertWSAError()`

See also [rfe #800716](https://core.tcl-lang.org/tcl/info/800716)

# Implementation

Implementation is in Tcl branch rfe-800716

# Compatibility

This is 100% upwards compatible with Tcl 8.6.

# Copyright

This document has been placed in the public domain.