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

3.69 NWsnmpReceive（）関数

■機能説明

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

■呼び出し形式

  
int NWsnmpReceive(NWSNMP_FD socket_id, char **pdu, int *len, 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      socket_id;    /* NWsnmpOpen関数で取得したソケットID */
char           *pdu;         /* GetResponsePDUの領域ポインタ */
int            len;          /* PDU長                        */
NWsnmpErrinfo  infoErr;      /* エラー通知構造体             */

−中略−

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