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<TITLE>NWC24CheckPublicMailAddr</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NWC24CheckPublicMailAddr</H1> 11 12<H2>C Specification</H2> 13<DL> 14<DD><PRE><CODE>#include <revolution/nwc24.h></CODE></PRE> 15<DD><PRE><CODE><A HREF="../Types/NWC24Err.html">NWC24Err</A> NWC24CheckPublicMailAddr( const char* <EM>addr</EM> );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20Checks the validity of an e-mail address.<BR>This function checks the validity of addresses, according to the following rules:<BR> 21<P> 22Mail addresses must be of the form:<BR><local-part>@<domain-part>.<BR><BR> <local-part> is a character string consisting of one or more printable ASCII characters, excluding the following:<BR> <code>()<>[]:;@\".</code><BR>Specifically, the allowed character set is as follows:<BR><code>!#$%&'*+-./0123456789=?ABCDEFGHIJKLMNOPQRSTUVWXYZ^_`</code><BR> <code>abcdefghijklmnopqrstuvwxyz{|}~</code><BR> <BR><domain-part> also consists of one or more ASCII characters. The usable character set is:<BR> <code>.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz</code><BR> (Alphanumeric characters, hyphens, periods, and underscores are allowed.)<BR>This part must not start with a period or contain more than one period in a row.<BR><BR> Furthermore, mail addresses with wii.com for the <domain-part> are also rejected. <BR>This specification is indented to prevent registering a Wii friend as a general friend. 23</P> 24 25<H2>Arguments</H2> 26<TABLE border="1" cellpadding="3" cellspacing="0.1"> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><code><em><strong>addr</strong></em></code></TD> 29 <TD width="520"> 30Pointer to the address string. 31 </TD> 32 </TR> 33</TABLE> 34 35<h2>Return Values</h2> 36<P> 37<code>NWC24_OK</code>: Normal exit.<BR> <code>NWC24_ERR_NULL</code>: Specified address is NULL.<BR> <code>NWC24_ERR_FORMAT</code>: E-mail address is invalid as a mail address.<BR> <code>NWC24_ERR_STRING_END</code>: Address is more than 255 characters.<BR> <code>NWC24_ERR_PROTECTED</code>: Recipient address contains "@wii.com".<BR> 38</P> 39 40<H2>See Also</H2> 41<P> 42</P> 43 44<H2>Revision History</H2> 45<P> 462006/12/05 Initial version. 47</P> 48 49<hr><p>CONFIDENTIAL</p></body> 50</HTML>