snmpFreeDescriptor 函数 (winsnmp.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
WinSNMP 应用程序使用 SnmpFreeDescriptor 函数通知 Microsoft WinSNMP 实现它不再需要访问描述符对象。 此 WinSNMP 函数向实现发出信号,以释放它为描述符对象分配的内存。
语法
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeDescriptor(
[in] smiUINT32 syntax,
[in] smiLPOPAQUE descriptor
);
参数
[in] syntax
指定目标描述符对象的语法数据类型。
[in] descriptor
指向 smiOPAQUE 结构的指针,该结构包含要发布的目标描述符对象。
返回值
如果函数成功,则返回值SNMPAPI_SUCCESS。
如果函数失败,则返回值SNMPAPI_FAILURE。 若要获取扩展错误信息,请调用 SnmpGetLastError,并在其会话参数中指定 NULL 值。 SnmpGetLastError 函数可能会返回以下错误之一。
返回代码 | 说明 |
---|---|
|
SnmpStartup 函数未成功完成。 |
|
内存分配期间出错。 |
|
语法参数无效。 |
|
描述符参数无效。 有关其他信息,请参阅以下“备注”部分。 |
|
发生未知或未定义错误。 |
注解
实现为长度可变的输出描述符对象分配和解除分配内存。 此内存分配和解除分配仅限于 实现, SnmpFreeDescriptor 函数提供的接口除外。 有关其他信息,请参阅 释放 WinSNMP 描述符。
如果 描述符 参数指定在先前调用 SnmpFreeDescriptor 时发布的实现的内存分配,则实现将返回SNMPAPI_OPERATION_INVALID错误代码。 如果 描述符 参数指定了实现未为调用 WinSNMP 应用程序执行的内存分配,则函数将返回相同的错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winsnmp.h |
Library | Wsnmp32.lib |
DLL | Wsnmp32.dll |