Systemwalker Centric Manager APIガイド - UNIX共通 -

3.48 NWsnmpReceive（）関数

◆機能説明

SNMP操作の応答を、PDU形式で受信します。

◆呼び出し形式

int NWsnmpReadSelect(int width, NWsnmpFd_Set* readfds, struct timeval timeout, NWsnmpErrinfo *infoErr)

◆パラメタ

入力パラメタ

socket_id:

NWsnmpOpen（）関数で獲得したソケットIDを指定します。

出力パラメタ

pdu:

受信PDUを指定します（領域は関数内で取得されます）。

len:

受信PDU長を指定します。

infoErr:

エラー情報設定構造体を指定します。

◆復帰値

1:

正常終了。

0:

異常終了。

◆備考

エラー時には、以下のコードが、NWsnmpErrinfo構造体のNWErrorCodeに設定されます。

NWSNMP_INVALIDSOCKET_ERR:

不当なソケットIDが設定されました。

NWSNMP_RECVFROM_ERR:

PDUの受信に失敗しました。

NWSNMP_MALLOC_ERR:

領域の獲得に失敗しました。

◆注意事項

• 受信PDU領域は関数内で取得されます。
  領域の解放は、NWsnmpFree（）関数で行ってください。
• GetResponse−PDUを受信するまで復帰しません。

◆使用例

NWSNMP_FD      sock_id;      /* NWsnmpOpen関数で取得したソケットID */
char           *pdu;         /* GetResponsePDUの領域ポインタ */
int            len           /* PDU長 */
NWsnmpErrinfo  infoErr;      /* エラー通知構造体 */

−中略−

if (!NWsnmpReceive(socket_id,&pdu, &len, &infoErr)) {
/* エラー処理 */
}