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