構文
char ConnectSc(
SOCKET sock,
struct sockaddr *pstrAddr,
unsigned char u8AddrLen
);
パラメータ
- sock
-
[in] ソケットディスクリプタ
- pstrAddr
-
[in] ソケットに接続するソケットアドレスをsockaddr構造体で指定します。
本ライブラリでは、sockaddr_in構造体の変数を定義し、キャストして指定します。 - u8AddrLen
-
[in] sockaddr構造体のサイズを指定します。
本ライブラリでは、sockaddr_in構造体のサイズを指定します。
戻り値
関数は次の値を返します。値 | 説明 |
---|---|
SOCK_ERR_NO_ERROR | ConnectSc関数の成功 |
M2M_ERR_SLEEP_FAIL | SysWLANInit関数により初期化を行ってください。 |
上記以外 | ConnectSc関数の失敗 |
解説
サーバーとの接続を行います。TCPソケットでのみ使用できます。
本関数の処理要求は非同期で処理されます。処理結果は、RegSocketCallbackSc関数のpfAppSocketCbパラメータで指定したコールバック関数で受け取ります。
コールバック関数のパラメータには次の値が渡されます。
- sock
- ソケットディスクリプタ
- u8Msg
- SOCKET_MSG_CONNECT
- pvMsg
- 処理結果を格納したtstrSocketConnectMsg構造体を指すポインタ。
tstrSocketConnectMsg構造体 (typedef)
構文
typedef struct {
SOCKET sock;
signed char s8Error;
} tstrSocketConnectMsg;
メンバー
- sock
- ConnectScの引数に指定したソケット。
- s8Error
- ConnectScの処理が成功したら0を、それ以外の場合は負の値を返します。
必要条件
ヘッダファイル:
lib.hライブラリファイル:
libSTARTUPOPH5000.a
サンプル
最終更新日:2020/11/26