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 函数可能会返回以下错误之一。

实现为长度可变的输出描述符对象分配和解除分配内存。此内存分配和解除分配仅限于实现， SnmpFreeDescriptor 函数提供的接口除外。有关其他信息，请参阅释放 WinSNMP 描述符。

如果 描述符 参数指定在先前调用 SnmpFreeDescriptor 时发布的实现的内存分配，则实现将返回SNMPAPI_OPERATION_INVALID错误代码。如果 描述符 参数指定了实现未为调用 WinSNMP 应用程序执行的内存分配，则函数将返回相同的错误代码。

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