通过

SnmpContextToStr 函数 (winsnmp.h)

  • 项目

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

WinSNMP SnmpContextToStr 函数返回一个字符串，该字符串标识 SNMP 上下文，该上下文是一组托管对象资源。 函数返回 smiOCTETS 结构中的字符串。

语法

SNMPAPI_STATUS SNMPAPI_CALL SnmpContextToStr(
  [in]  HSNMP_CONTEXT context,
  [out] smiLPOCTETS   string
);

参数

[in] context

感兴趣的 SNMP 上下文的句柄。

[out] string

指向 smiOCTETS 结构的指针，用于接收标识相关上下文的字符串。 字符串可以具有 null 终止字节。

返回值

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

如果函数失败，则返回值SNMPAPI_FAILURE。 若要获取扩展错误信息，请调用 SnmpGetLastError。 SnmpGetLastError 函数可能会返回以下错误之一。

返回代码 说明
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 函数未成功完成。
SNMPAPI_ALLOC_ERROR
 内存分配期间出错。
SNMPAPI_CONTEXT_INVALID
 上下文参数无效。
SNMPAPI_OTHER_ERROR
 发生未知或未定义错误。

注解

实体和上下文转换模式的当前设置确定返回的输出字符串 SnmpContextToStr 的类型。 有关其他信息，请参阅 设置实体和上下文转换模式。

WinSNMP 应用程序必须为字符串参数提供有效 smiOCTETS 结构的地址。 如果 SnmpContextToStr 函数成功完成，Microsoft WinSNMP 实现将初始化结构的 len 和 ptr 成员。 WinSNMP 应用程序必须调用 SnmpFreeDescriptor 函数，使实现能够释放这些成员的资源。

当实体和上下文转换模式SNMPAPI_TRANSLATED且该条目存在于实现的数据库中时，实现将返回上下文的关联用户友好名称。 如果上下文名称不存在条目， SnmpContextToStr 将返回 SNMP 社区字符串。

当实体和上下文转换模式SNMPAPI_UNTRANSLATED_V1或SNMPAPI_UNTRANSLATED_V2时，实现还会返回 SNMP 社区字符串。

要求

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

另请参阅

SnmpFreeDescriptor

WinSNMP 函数

WinSNMP API 概述

smiOCTETS