设置实体和上下文转换模式
WinSNMP 应用程序可以通过设置实体和上下文转换模式来指定实体和上下文参数的解释和转换。 Microsoft WinSNMP 实现将模式存储在数据库中。
实体和上下文转换模式的设置确定 SnmpStrToEntity 函数和 SnmpStrToContext 函数解释输入字符串的方式。 该设置还确定 SnmpEntityToStr 和 SnmpContextToStr 函数返回的输出字符串的类型。 有关详细信息,请参阅 WinSNMP 中对 IPX 地址字符串的支持。
实现在 SnmpStartup 函数的 nTranslateMode 参数中返回当前默认实体和上下文转换模式。 若要检索对实现有效的当前实体和上下文转换模式,应用程序可以随时调用 SnmpGetTranslateMode 函数。
接下来是有效的实体和上下文转换模式。
模式 | 含义 |
---|---|
SNMPAPI_TRANSLATED | 实现使用其数据库来转换 SNMP 实体和托管对象的用户友好名称。 实现将它们转换为其 SNMPv1 或 SNMPv2C 组件。 |
SNMPAPI_UNTRANSLATED_V1 | 实现将 SNMP 实体参数解释为文本 SNMP 传输地址,将上下文参数解释为文本 SNMP 社区字符串。 对于 SNMPv2 目标实体,实现会创建在版本字段中包含值为零的传出 SNMP 消息。 |
SNMPAPI_UNTRANSLATED_V2 | 实现将 SNMP 实体参数解释为 SNMP 传输地址,将上下文参数解释为文本 SNMP 社区字符串。 对于 SNMPv2 目标实体,实现会创建在版本字段中包含值 1 的传出 SNMP 消息。 |
实现尝试将其数据库中的资源与管理实体的文本传输地址相关联。
若要更改实体和上下文转换模式设置 WinSNMP 应用程序必须调用 SnmpSetTranslateMode 函数。 如果请求的转换模式无效,则该函数将失败, SnmpGetLastError SNMPAPI_MODE_INVALID返回错误代码。