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

3.54 NWsnmpTrapdReceive（）関数

◆機能説明

トラップデーモンより、TRAPデータをPDU形式で受信します。

◆呼び出し形式

int NWsnmpTrapdReceive(NWSNMP_FD socket_id, char** pdu, int *len, NWsnmpErrinfo *infoErr)

◆パラメタ

入力パラメタ

socket_id:

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

出力パラメタ

pdu:

受信TRAP－PDUを指定します（領域は関数内で確保されます）。

len:

受信TRAP－PDU長を指定します。

infoErr:

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

◆復帰値

1:

正常終了。

0:

異常終了。

◆備考

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

NWSNMP_INVALIDSOCKET_ERR:

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

NWSNMP_RECV_ERR:

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

NWSNMP_TRAPD_TERMINATE:

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

NWSNMP_MALLOC_ERR:

トラップデーモンが停止しました。

◆注意事項

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

◆使用例

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

－中略－

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