SnmpFreePdu 関数 (winsnmp.h)
[SNMP は、[要件] セクションで指定したオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
WinSNMP SnmpFreePdu 関数は、 SnmpCreatePdu または SnmpDuplicatePdu 関数によって作成された SNMP プロトコル データ ユニット (PDU) に関連付けられているリソースを解放します。
構文
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
パラメーター
[in] PDU
解放する SNMP PDU へのハンドル。
戻り値
関数が成功した場合、戻り値はSNMPAPI_SUCCESS。
関数が失敗した場合、戻り値はSNMPAPI_FAILURE。 拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。
| リターン コード | 説明 |
|---|---|
|
SnmpStartup 関数が正常に完了しませんでした。 |
|
メモリ割り当て中にエラーが発生しました。 |
|
PDU ハンドルが無効です。 |
|
不明または未定義のエラーが発生しました。 |
注釈
アプリケーションが SnmpClose または SnmpCleanup 関数を呼び出す場合、Microsoft WinSNMP 実装は WinSNMP セッションに割り当てるすべてのリソースを解放します。 ただし、アプリケーションでは、リソースに対応する WinSNMP 関数を使用して個々のリソースを解放することをお勧めします。 これにより、実装の作業負荷が軽減され、実装のサービスをすべてのアプリケーションに拡張する必要があります。 アプリケーションでは 、SnmpFreeVbl 関数を使用して、変数バインド リスト リソースの割り当てを解除する必要があります。 詳細については、「WinSNMP データ管理の概念」を参照してください。
WinSNMP では、変数バインド リストに 1 つのエントリのみが含まれている場合でも、変数バインド エントリは変数バインド リスト内にのみ存在します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winsnmp.h |
| Library | Wsnmp32.lib |
| [DLL] | Wsnmp32.dll |