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>NCDIsInterfaceDecided</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NCDIsInterfaceDecided</H1>
11
12<H2>Syntax</H2>
13<DL>
14  <DD><PRE><CODE>#include &lt;revolution/ncd.h&gt;</CODE></PRE>
15  <DD><PRE><CODE>BOOL    NCDIsInterfaceDecided( void );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Investigates whether the network interface is established and ready for communications in the NCD automatic state transition.
21</P>
22
23<H2>Arguments</H2>
24<P>None.</P>
25
26<h2>Return Values</h2>
27<P>
28Returns TRUE when the network interface is established. Returns <CODE>FALSE</CODE> either when the network interface is not established or when the process fails.<br> In particular, be aware that if the interface is configured for wireless, <CODE>FALSE</CODE> will be returned until the configured access point is discovered.<br>
29</P>
30<P>
31If this function returns <CODE>FALSE</CODE>, do not assume that communications are impossible and prevent network features such as Nintendo Wi-Fi Connection from being used. Instead, use an SO function to attempt a connection to the network device, and determine if communications are actually possible.<br /> As described above, <CODE>FALSE</CODE> will even be returned during a search for an access point, so this function's return value cannot be used to determine if communications are possible.
32</P>
33
34<H2>See Also</H2>
35<P>
36<A href="NCDSetIfConfig.html"><CODE>NCDSetIfConfig</CODE></A>
37</P>
38
39<H2>Revision History</H2>
40<P>
412008/01/18 Added a note. <br>2006/08/09 Initial version.
42</P>
43
44<hr><p>CONFIDENTIAL</p></body>
45</HTML>