NNS_McsIsServerConnect

構文

#include <nnsys/mcs.h>
BOOL NNS_McsIsServerConnect(void);

引数

なし。

返り値

mcsサーバがニンテンドーDSハードウェアに対して接続している場合はTRUE、切断している場合は、FALSEを返します。

説明

mcsサーバがニンテンドーDSハードウェアに対して接続しているか、あるいは切断しているかの状態を取得します。ただし、この関数が返す値はmcsサーバの状態と完全に同期しているわけではありません。mcsの通信機能を使用して状態を取得しているため、mcsサーバの状態がニンテンドーDS側で判断できるようになるまで若干のタイムラグが生じます。

戻り値がTRUEのときは、mcsサーバがニンテンドーDSハードウェアに対して接続していることを示します。戻り値がFALSEのときは、mcsサーバがニンテンドーDSハードウェアに対して一度も接続していないか、接続した後で切断していることを示しています。

状態の取得にmcsの通信機能を使用しているため、関数NNS_McsOpenを用いて通信が開始されている必要があります。また、内部で関数NNS_McsPollingIdleを呼び出しています。

参照

NNS_McsOpen, NNS_McsPollingIdle

履歴

2005/01/24 初版