snmpSetTranslateMode 函数 (winsnmp.h)

项目
03/04/2024

[SNMP 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。请改用 Windows 远程管理，这是 WS-Man 的 Microsoft 实现。]

WinSNMP SnmpSetTranslateMode 函数使 WinSNMP 应用程序能够更改实体和上下文转换模式。实体和上下文转换模式会影响 WinSNMP 输入和输出字符串参数的解释和返回。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

参数

[in] nTranslateMode

指定新实体和上下文转换模式的值。此参数须为下列值之一。

值	含义
SNMPAPI_TRANSLATED	Microsoft WinSNMP 实现使用其数据库来转换 SNMP 实体和托管对象的用户友好名称。实现将它们转换为其 SNMPv1 或 SNMPv2C 组件。
SNMPAPI_UNTRANSLATED_V1	实现将 SNMP 实体参数解释为 SNMP 传输地址，将上下文参数解释为 SNMP 社区字符串。对于 SNMPv2 目标实体，实现会创建在版本字段中包含值为零的传出 SNMP 消息。
SNMPAPI_UNTRANSLATED_V2	实现将 SNMP 实体参数解释为 SNMP 传输地址，将上下文参数解释为 SNMP 社区字符串。对于 SNMPv2 目标实体，实现会创建在版本字段中包含值 1 的传出 SNMP 消息。

返回值

如果函数成功，则返回值SNMPAPI_SUCCESS。

如果函数失败，则返回值SNMPAPI_FAILURE。若要获取扩展错误信息，请调用 SnmpGetLastError，并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。

返回代码	说明
SNMPAPI_NOT_INITIALIZED	SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR	内存分配期间出错。
SNMPAPI_MODE_INVALID	实现不支持请求的转换模式。
SNMPAPI_OTHER_ERROR	发生未知或未定义错误。

注解

新的实体和上下文转换模式会影响对 SnmpStrToEntity、 SnmpStrToContext、 SnmpContextToStr 和 SnmpEntityToStr 函数的后续调用。 WinSNMP 应用程序可以通过对具有不同 nTranslateMode 值的 SnmpSetTranslateMode 进行另一次调用来再次更改实体和上下文转换模式。

有关其他信息，请参阅设置实体和上下文转换模式。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winsnmp.h
Library	Wsnmp32.lib
DLL	Wsnmp32.dll