1<!DOCTYPE HTML PUBLIC "-//W3C//Dtd HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<link rel="stylesheet" type="text/css" href="../../CSS/revolution.css" />
7<title>ENCGetExternalEncoding</title>
8</head>
9
10<body>
11
12<h1>ENCGetExternalEncoding</h1>
13
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution/enc.h&gt;
18
19ENCResult ENCGetExternalEncoding(const ENCContext* context, u8* encoding);
20</pre></dd></dl>
21
22<h2>Arguments</h2>
23<TABLE class="arguments" border="1" >
24    <tr>
25<th>context</th>
26<td>Character code conversion context.</td>
27    </tr>
28    <tr>
29<th>encoding</th>
30<td>Character string expression of the external character encoding name.</td>
31    </tr>
32</table>
33
34<h2>Return Values</h2>
35<p>
36<code>ENC_OK</code>: Normal exit.<br><code>ENC_ERR_INVALID_PARAM</code>: Invalid argument.<br><code>ENC_ERR_UNKNOWN_ENCODING</code>: Unknown character encoding.<br>
37</p>
38
39<h2>Description</h2>
40<p>
41Gets an external character encoding name as a string from a character code conversion context.<br>Refer to the <a href="../intro.html">ENC API Introduction</a> for details on supported character encodings.
42</p>
43<p>The maximum character string length including the character encoding name termination character is defined as <code>ENC_ENCODING_NAME_LENGTH</code>.</p>
44
45<h2>See Also</h2>
46<P class="reference">
47<a href="../intro.html">ENC API Introduction</a><BR><a href="../Conversion/ENCSetExternalEncoding.html">ENCSetExternalEncoding</a>
48</p>
49
50<h2>Revision History</h2>
51<p>
522008/07/08 Added an explanation and link related to supported character encodings.<br>2006/10/19 Initial version.<br>
53</p>
54
55<hr><p>CONFIDENTIAL</p></body>
56</html>