釋放 WinSNMP 描述元

WinSNMP 程式設計環境會將描述項資源的解除配置指派給 WinSNMP 實作或 WinSNMP 應用程式，視描述元配置記憶體的元件而定。

若要釋放 smiOID 或 smiOCTETS 描述元的資源，適用下列規則：

• 針對輸入參數

  由於 WinSNMP 應用程式會為具有可變長度的輸入物件配置記憶體，因此應用程式必須使用適當的函式釋放該記憶體。 例如，如果應用程式使用 對 GlobalAlloc 函式的呼叫來配置資源，它應該使用 GlobalFree 函式來解除配置資源。 如果應用程式使用 對 HeapAlloc 函式的呼叫來配置資源，它應該呼叫 HeapFree 函式。

• 針對輸出參數

  呼叫下列任何函式會導致為smiOID 或smiOCTETS描述項配置記憶體的實作：SnmpGetVb、SnmpEncodeMsg、SnmpOidCopy、SnmpCoNtextToStr 和 SnmpStrToOid。

  因為實作會為這些輸出物件配置記憶體，所以應用程式必須呼叫 SnmpFreeDescriptor 函式來解除配置資源。 此函式可讓實作釋放配置給這些結構的 ptr 成員的記憶體。

若要釋放smiVALUE結構的資源，WinSNMP 應用程式必須檢查smiVALUE結構的語法成員，才能正確評估 結構的值成員。 如果 語法 成員指出 值 成員是 smiOCTETS 或 smiOID 描述元，而且實作已為描述元配置資源，則應用程式必須呼叫 SnmpFreeDescriptor。 這可讓 實作釋放記憶體。 如果應用程式佈建資源，則必須使用適當的函式釋放記憶體，如先前所述。

如需詳細資訊，請參閱 配置 WinSNMP 記憶體物件。