前のページ次のページ上に戻るホーム SophiaFramework UNIVERSE 5.3
SFBNetMgr
INetMgr インターフェースのラッパークラスです。
#include <SFBNetMgr.h.hpp>
class SFBNetMgr : public SFBNotifier;
SFMTYPEDEFWRAPPER(SFBNetMgr)

継承図

SFBNetMgr クラスの継承図

バージョン

BREW 2.0 BREW 2.1 BREW 3.1 BREW 4.0

参照

BREW API INetMgr

メンバ

パブリック関数
SFCError GetDefaultNetwork( SInt32Ptr network )
デフォルトのデータ ネットワークを取得します。
SInt32 GetDefaultNetwork( Void )
デフォルトのデータ ネットワークを取得します。
Void GetHostByName( AEEDNSResult* result , ACharConstPtr domain , SFXCallbackPtr callback )
指定したホスト名に関連する IP アドレスを取得します。
Void GetHostByName( AEEDNSResult* result , SFXAnsiStringConstRef domain , SFXCallbackPtr callback )
指定したホスト名に関連する IP アドレスを取得します。
SFCError GetLastError( Void )
INetMgr インターフェースで発生した最後のエラーを取得します。
INAddr GetMyIPAddr( Void )
ローカルホストまたはデバイスの IP アドレスを取得します。
SFCError GetOpt( SInt32 optName , VoidPtr value , SInt32Ptr size )
特定のネットワーク オプションを取得します。
SFCError GetOpt( SInt32 optName , SFXBufferPtr value )
特定のネットワーク オプションを取得します。
SFCError GetUMTSCount( UInt16Ptr count )
パケット データ プロファイルの数を取得します( UMTS のみ )。
NetState NetStatus( AEENetStats* stats )
現在のネットワークのステータスを取得します。
static
SFBNetMgrSmp
NewInstance( SFCErrorPtr exception = null )
SFBNetMgr インスタンスを生成します。
static
SFBNetMgrSmp
NewInstance( AEECLSID id , SFCErrorPtr exception = null )
SFBNetMgr インスタンスを生成します。
SInt32 OnEvent( PFNNETMGREVENT notify , VoidPtr data = null , Bool reg = true )
実行中の SFBNetMgr の処理のコールバックを登録します。
SFBSocketSmp OpenSocket( NetSocket type )
ソケットを作成し、SFBSocket インターフェースへのポインタを取得します。
SInt32 RegisterEvent( PFNNETMGREVENT notify , VoidPtr data = null )
コールバック関数を登録します。
SFCError SelectNetwork( SInt32 network )
特定のデータ ネットワークを選択します。
UInt16 SetLinger( UInt16 secs )
ネットワーク接続の待機時間を、secs で指定した値に設定し、以前の設定値を取得します。
SFCError SetOpt( SInt32 optName , VoidPtr value , SInt32 size )
特定のネットワーク オプションを設定します。
SFCError SetOpt( SInt32 optName , SFXBufferPtr value )
特定のネットワーク オプションを設定します。
SInt32 UnregisterEvent( PFNNETMGREVENT notify , VoidPtr data = null )
コールバック関数の登録を解除します。
プロテクト関数
static
SFBBaseSmp
FactoryByCreate( AEECLSID id , SFCErrorPtr exception = null ) (SFBBase から継承)
指定したクラス ID のインターフェースのインスタンスを生成します。
static
SFBBaseSmp
FactoryByQuery( SFBQuerySmpConstRef query , AEECLSID id , SFCErrorPtr exception = null ) (SFBBase から継承)
指定したクラス ID のインターフェースのインスタンスを指定した SFBQuery インスタンスを使用して生成します。

SFBNetMgr::GetDefaultNetwork
デフォルトのデータ ネットワークを取得します。
[ public ]
SFCError GetDefaultNetwork(
    SInt32Ptr network   // network へのポインタ
                        // AEE_NETWORK_* が読み込まれる
);
[ public ]
SInt32 GetDefaultNetwork(Void);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 失敗したとき: SFERR_FAILED

バージョン

この関数は、BREW 3.0.2 から使用可能です

参照

BREW API INETMGR_GetDefaultNetwork | SFBNetMgr::SelectNetwork | SFBNetMgr::GetOpt


SFBNetMgr::GetHostByName
指定したホスト名に関連する IP アドレスを取得します。
[ public ]
Void GetHostByName(
    AEEDNSResult* result      // 結果構造体へのポインタ
    ACharConstPtr domain      // 解決するドメイン名
                              // コロン( : )、スラッシュ( / )、または null ( \0 ) で終結する必要がある
    SFXCallbackPtr callback   // コールバックへのポインタ
);
[ public ]
Void GetHostByName(
    AEEDNSResult* result           // 結果構造体へのポインタ
    SFXAnsiStringConstRef domain   // 解決するドメイン名
                                   // コロン( : )、スラッシュ( / )、または null ( \0 ) で終結する必要がある
    SFXCallbackPtr callback        // コールバックへのポインタ
);

参照

BREW API INETMGR_GetHostByName | AEEDNSResult | SFXCallback


SFBNetMgr::GetLastError
INetMgr インターフェースで発生した最後のエラーを取得します。
[ public ]
SFCError GetLastError(Void);

戻り値

AEEError.h で定義されているエラー値を返します。

参照

BREW API INETMGR_GetLastError


SFBNetMgr::GetMyIPAddr
ローカルホストまたはデバイスの IP アドレスを取得します。
[ public ]
INAddr GetMyIPAddr(Void);

参照

BREW API INETMGR_GetMyIPAddr


SFBNetMgr::GetOpt
特定のネットワーク オプションを取得します。
[ public ]
SFCError GetOpt(
    SInt32 optName   // 取得するオプションを指定する整数
    VoidPtr value    // オプション固有のデータを格納する
    SInt32Ptr size   // value が非 null の場合、入力時は pOptVal のサイズを指定する
                     // このサイズは、オプションデータの要求サイズに一致しなければならない
                     // value が null の場合、入力時は無効になり、出力時はオプション データの要求サイズを格納する
);
[ public ]
SFCError GetOpt(
    SInt32 optName       // 取得するオプションを指定する整数
    SFXBufferPtr value   // オプション固有のデータが格納される
                         // サイズは自動的に変更される
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 引数が不正なとき: SFERR_INVALID_PARAM
  • メモリ不足のとき: SFERR_NO_MEMORY
  • 失敗したとき: SFERR_FAILED
  • オプションへのアクセスがアプレット特権によって禁止されているとき: EPRIVLEVEL
  • optName が不明なとき: SFERR_UNSUPPORTED

参照

BREW API INETMGR_GetOpt | SFBNetMgr::SetOpt


SFBNetMgr::GetUMTSCount
パケット データ プロファイルの数を取得します( UMTS のみ )。
[ public ]
SFCError GetUMTSCount(
    UInt16Ptr count   // PDP の数が読み込まれる
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 失敗したとき: SFERR_FAILED
  • ネットワークが有効でないとき: AEE_NET_EINVAL

バージョン

この関数は、BREW 3.0.2 から使用可能です

参照

BREW API INETMGR_GetUMTSCount | SFBNetMgr::SelectNetwork | SFBNetMgr::GetOpt


SFBNetMgr::NetStatus
現在のネットワークのステータスを取得します。
[ public ]
NetState NetStatus(
    AEENetStats* stats   // 統計データを格納するブロックへのポインタ
);

使用例

ネットワークの状態を取得し、ログに表示します。

NetState      state;
AEENetStats   stats;

// SFBNetMgr インスタンスを作成する 
SFBNetMgrSmp    netmgr = SFBNetMgr::NewInstance();

// ネットワークの状態を取得する 
state = netmgr->NetStatus(&stats);

// ネットワークの状態をログに表示する 
switch (state) {
case NET_INVALID_STATE:
    TRACE ("*** Status: Invalid ***");
    break;

case NET_PPP_OPENING:
    DBGPRINTF ("*** Status: Opening ***");
    TRACE;

case NET_PPP_OPEN:
    TRACE ("*** Status: Open ***");
    break;

case NET_PPP_CLOSING:
    TRACE ("*** Status: Closing ***");
    break;

case NET_PPP_CLOSED:
    TRACE ("*** Status: Closed ***");
    break;

case NET_PPP_SLEEPING:
    TRACE ("*** Status: Sleeping ***");
    break;

case NET_PPP_ASLEEP:
    TRACE ("*** Status: ASleep ***");
    break;

case NET_PPP_WAKING:
    DBGPRINTF ("*** Status: Waking ***");
    break;
}

参照

BREW API INETMGR_NetStatus | AEENetStats | NetState


SFBNetMgr::NewInstance
SFBNetMgr インスタンスを生成します。
[ public, static ]
SFBNetMgrSmp NewInstance(
    SFCErrorPtr exception = null   // エラー値
);
[ public, static ]
SFBNetMgrSmp NewInstance(
    AEECLSID id                    // クラスID
    SFCErrorPtr exception = null   // エラー値
);

SFBNetMgr::OnEvent
実行中の SFBNetMgr の処理のコールバックを登録します。
[ public ]
SInt32 OnEvent(
    PFNNETMGREVENT notify   // イベント発生時にコールされる、ユーザー指定のコールバック
    VoidPtr data = null     // コールバックへの第 1 引数として渡される、ユーザー指定のコンテキストデータ
    Bool reg = true         // 登録する場合は true、登録を解除する場合は false
);

参照

BREW API INETMGR_OnEvent | PFNNETMGREVENT


SFBNetMgr::OpenSocket
ソケットを作成し、SFBSocket インターフェースへのポインタを取得します。
[ public ]
SFBSocketSmp OpenSocket(
    NetSocket type   // 次のソケットのタイプを指定する
                     // TCP : AEE_SOCK_STREAM / UDP : AEE_SOCK_DGRAM
);

参照

BREW API INETMGR_OpenSocket | NetSocket | SFBSocket


SFBNetMgr::RegisterEvent
コールバック関数を登録します。
[ public ]
SInt32 RegisterEvent(
    PFNNETMGREVENT notify   // イベント発生時にコールされる、ユーザー指定のコールバック関数
    VoidPtr data = null     // コールバックへの第 1 引数として渡される、ユーザー指定のコンテキストデータ
);

解説

この関数は SFBNetMgr::OnEvent( pfn , pUser , true ) を呼び出すのと同じです。

参照

SFBNetMgr::OnEvent | SFBNetMgr::UnregisterEvent | SFBNetMgr::OnEvent


SFBNetMgr::SelectNetwork
特定のデータ ネットワークを選択します。
[ public ]
SFCError SelectNetwork(
    SInt32 network   // データ ネットワーク
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 失敗したとき: SFERR_FAILED
  • ネットワークが有効でないとき: AEE_NET_EINVAL
  • ネットワークが既に選択されているとき: AEE_NET_EOPNOTSUPP

バージョン

この関数は、BREW 3.0.2 から使用可能です

参照

BREW API INETMGR_GetUMTSCount | SFBNetMgr::SelectNetwork | SFBNetMgr::GetOpt


SFBNetMgr::SetLinger
ネットワーク接続の待機時間を、secs で指定した値に設定し、以前の設定値を取得します。
[ public ]
UInt16 SetLinger(
    UInt16 secs   // 待機時間( 秒 )
);

使用例

ネットワーク接続の待機時間を設定します。

// SFBNetMgr インスタンスを作成する
SFBNetMgrSmp    netmgr = SFBNetMgr::NewInstance();

// ネットワーク接続の待機時間を 5 秒に設定する
netmgr->SetLinger(5);

参照

BREW API INETMGR_SetLinger


SFBNetMgr::SetOpt
特定のネットワーク オプションを設定します。
[ public ]
SFCError SetOpt(
    SInt32 optName   // 設定するオプションを指定する整数
    VoidPtr value    // オプション固有のデータが格納される
    SInt32 size      // value のサイズ
);
[ public ]
SFCError SetOpt(
    SInt32 optName       // 設定するオプションを指定する整数
    SFXBufferPtr value   // オプション固有のデータが格納される
                         // null の場合、何もせずに SFERR_INVALID_PARAM を返す
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 引数が不正なとき: SFERR_INVALID_PARAM
  • オプションへのアクセスがアプレット特権によって禁止されているとき: EPRIVLEVEL
  • optName が不明なとき: SFERR_UNSUPPORTED

参照

BREW API INETMGR_SetOpt | SFBNetMgr::GetOpt


SFBNetMgr::UnregisterEvent
コールバック関数の登録を解除します。
[ public ]
SInt32 UnregisterEvent(
    PFNNETMGREVENT notify   // 解除するコールバック関数
    VoidPtr data = null     // コールバックへの第 1 引数として渡される、ユーザー指定のコンテキストデータ
);

解説

この関数は SFBNetMgr::OnEvent( pfn , pUser , false ) を呼び出すのと同じです。

参照

SFBNetMgr::OnEvent | SFBNetMgr::RegisterEvent | SFBNetMgr::OnEvent