Systemwalker Centric Manager APIガイド - Microsoft(R) Windows NT(R)/ Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 -

3.71 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)) {) {
        /* エラー処理 */
}