SnmpMgrRequest函数请求指定的代理执行指定的操作。
SNMPAPI SnmpMgrRequest(
LPSNMP_MGR_SESSION【会议】, | // SNMP会话指针 |
BYTE【请求类型】, | // Get,GetNext或Set |
RFC1157VarBindList【* variableBindings】, | //变量绑定 |
AsnInteger *【ErrorStatus中】,【】 | //结果错误状态 |
AsnInteger【* ErrorIndex】 | //结果错误索引 |
); |
参数
【会议】
[in]指向内部结构,指定执行请求的会话。
【请求类型】
[in]指定SNMP请求类型。此参数可以是以下值之一:
值 | 含义 |
ASN_RFC1157_GETREQUEST | 搜索并从指定的变量接收值。 |
ASN_RFC1157_GETNEXTREQUEST | 在不知道变量的名称的情况下,从变量搜索并接收值。 |
ASN_RFC1157_SETREQUEST | 将值存储在特定变量中。 |
【variableBindings】
[in/out]指向变量绑定列表。
【ErrorStatus中】
[out]指向将返回错误状态结果的变量。此参数可以是以下值之一:
值 | 含义 |
SNMP_ERRORSTATUS_NOERROR | 代理报告传输过程中没有发生错误。 |
SNMP_ERRORSTATUS_TOOBIG | 代理无法将请求的操作的结果放在单个SNMP消息中。 |
SNMP_ERRORSTATUS_NOSUCHNAME | 请求的操作确定了一个未知变量。 |
SNMP_ERRORSTATUS_BADVALUE | 请求的操作尝试更改变量,但指定了语法或值错误。 |
SNMP_ERRORSTATUS_READONLY | 请求的操作尝试根据变量的社区概要更改不允许更改的变量。 |
SNMP_ERRORSTATUS_GENERR | 在所请求的操作期间发生的其他错误之外的错误发生。 |
【ErrorIndex】
[out]指向将返回错误索引结果的变量。
返回值
如果函数成功,返回值为TRUE。
如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
错误代码 | 含义 |
SNMP_MGMTAPI_TIMEOUT | 请求超时 |
SNMP_MGMTAPI_SELECT_FDERRORS | Windows Sockets 选择 功能指示的意外错误文件描述符 |
备注
重试和超时提供给SnmpMgrOpen功能。必须初始化变量绑定列表中的每个变量才能为得到和获取下一个请求键入ASN_NULL。
有关详细信息,请参阅RFC 1157.
也可以看看