# snmp3_get

(PHP 4, PHP 5, PHP 7)

snmp3_get — Fetch an SNMP object

### 说明

snmp3_get ( string `$host` , string `$sec_name` , string `$sec_level` , string `$auth_protocol` , string `$auth_passphrase` , string `$priv_protocol` , string `$priv_passphrase` , string `$object_id` [, int `$timeout` = 1000000 [, int `$retries` = 5 ]] ) : string

The snmp3_get() function is used to read the value of an SNMP object specified by the `object_id`.

### 参数

`host`

  The hostname of the SNMP agent (server).

`sec_name`

  the security name, usually some kind of username

`sec_level`

  the security level (noAuthNoPriv|authNoPriv|authPriv)

`auth_protocol`

  the authentication protocol (MD5 or SHA)

`auth_passphrase`

  the authentication pass phrase

`priv_protocol`

  the privacy protocol (DES or AES)

`priv_passphrase`

  the privacy pass phrase

`object_id`

  The SNMP object id.

`timeout`

  The number of microseconds until the first timeout.

`retries`

  The number of times to retry if timeouts occur.

### 返回值

Returns SNMP object value on success or `FALSE` on error.

### 范例

Example #1 Using snmp3_get()

    <?php
    $nameOfSecondInterface = snmp3_get('localhost', 'james', 'authPriv', 'SHA', 'secret007', 'AES', 'secret007', 'IF-MIB::ifName.2');
    ?>

### 参见

- snmp3_set() - Set the value of an SNMP object