1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 8<title>DWC_CheckProfanityAsync</title> 9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13<a name="dwc__prof_8h_16e8029f668632188e74681738be0aa20"></a> 14<h1 align="left">DWC_CheckProfanityAsync</h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <dwc.h></CODE><BR> 20 <BR> 21 <PRE><CODE>BOOL <a href=DWC_CheckProfanityAsync.html#dwc__prof_8h_16e8029f668632188e74681738be0aa20>DWC_CheckProfanityAsync</a>(const u16 **words, 22 int wordsnum, 23 const char *reserved, 24 int timeout, 25 char *result, 26 int *badwordsnum);</CODE></PRE></dd> 27</dl> 28 29<h2>Arguments</h2> 30 31<TABLE border="1" width="100%"> 32 <TBODY> 33 34 <TR> 35<TD width="13%"><EM><STRONG>words</STRONG></EM></TD> 36<TD width="87%">Pointer to the string array to be checked.<ul><li>Use Unicode (big-endian UTF16) for the character code. If you are using a different character code, be sure to convert to Unicode.<br></li><li>If the screen name contains a special character not found in Unicode or the IPL font, replace it with a space.<br></li><li>The terminal character must be "" ("0x0000" in u16).<br></li><li>The total of all strings within the array must be no greater than 501 characters (including the terminal characters of each string).<br></li></ul></TD> 37 </TR> 38 39 <TR> 40<TD width="13%"><EM><STRONG>wordsnum</STRONG></EM></TD> 41<TD width="87%">The number of elements in the string array specified by words (1-50).</TD> 42 </TR> 43 44 <TR> 45<TD width="13%"><EM><STRONG>reserved</STRONG></EM></TD> 46<TD width="87%">Specify NULL.</TD> 47 </TR> 48 49 <TR> 50<TD width="13%"><EM><STRONG>timeout</STRONG></EM></TD> 51<TD width="87%">The server response timeout interval (in milliseconds).<br>(If 0 or less is specified, the default value of 10000 will be used.)</TD> 52 </TR> 53 54 <TR> 55<TD width="13%"><EM><STRONG>result</STRONG></EM></TD> 56<TD width="87%">A pointer to the location that stores the results of the check (requires an area of <CODE>wordsnum</CODE> bytes).</TD> 57 </TR> 58 59 <TR> 60<TD width="13%"><EM><STRONG>badwordsnum</STRONG></EM></TD> 61<TD width="87%">A pointer to the location that stores the number of illegal strings contained in the results of the check.</TD> 62 </TR> 63 64 </TBODY> 65</TABLE> 66 67<h2>Return Values</h2> 68 69<TABLE border="1" width="100%"> 70 <TBODY> 71 72 <TR> 73<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD> 74<TD width="87%">The check for illegal strings has started.</TD> 75 </TR> 76 77 <TR> 78<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD> 79<TD width="87%">The check for illegal strings failed to start.</TD> 80 </TR> 81 82 </TBODY> 83</TABLE> 84 85<H2>Description</H2> 86<p>Starts the check for illegal strings. It always returns FALSE if called while an illegal string check is in progress.</p><p>The illegal string check is performed by communicating with the authentication server. The process is similar to that of the <CODE>DWC_LoginAsync</CODE> function in the way it checks contents. It is also similar in that the check is done by the word. In addition to being able to check for individual illegal strings, this function can check multiple strings at once within the following limits:<ul><li>It can check up to 50 strings at once.<br></li><li>The total length of all the strings, including the terminal characters of each string, can be up to 501 characters.<br></li></ul></p><p>After calling this function, proceed to check for illegal strings by calling the <A href="DWC_CheckProfanityProcess.html"><CODE>DWC_CheckProfanityProcess</CODE></a> function approximately every game frame. When the illegal string check completes successfully, the results of the check will be stored as an array.</p><p>If one of the strings given to <CODE>words</CODE> for checking is illegal, the result of the check stored in <CODE>result</CODE> will contain 1. Otherwise, the result will contain 0. These results are stored in the same order as the checked strings.</p><p>[Example]<br> <br><CODE>words[4]={L"goodoword1",L"goodoword2",L"badword",L"goodoword3"}</CODE><br><br>If in the above group of strings only the third index ("badword") is an illegal string, the following will result:<br><br><CODE>result[4]={0,0,1,0}<br>badwordsnum=1</CODE><br></p><p>This function calls the <CODE>NHTTPStartup</CODE> function internally. Avoid the overlapping use of NHTTP before and after the interval between the time this function is called and the illegal string check is performed.</p> 87 88<h2>See Also</h2> 89<p> 90 91 <CODE><A href="DWC_CheckProfanityExAsync.html">DWC_CheckProfanityExAsync</A></CODE> 92 93</p> 94 95<H2>Revision History</H2> 96<DL> 97 98<DT><para>1.4.12</DT> 99<DD>Added information specific to conflicts in NHTTP.</DD> 100 101<DT><para>1.4.6</DT> 102<DD>Corrected error: "If 0 is specified" was changed to "If 0 or less is specified".</DD> 103 104<DT><para>1.4.1</DT> 105<DD>Initial version.</DD> 106 107</DL> 108<hr><p>CONFIDENTIAL</p></body> 109</html> 110