Systemwalker Centric Manager APIガイド - UNIX/Windows(R)共通 -

3.70 NWsnmpTrapdReceive（）関数

■機能説明

トラップ受信サービス、またはトラップデーモンから、SNMPトラップデータを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       *socket_id;    /* NWsnmpTrapdOpen関数で取得したソケットID */
char            *pdu;          /* TRAP−PDUの格納ポインタ */
int             len;           /* PDU長                   */
NWsnmpErrinfo   infoErr;       /* エラー通知構造体        */

−中略−

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