SnmpMgrClose 関数 (mgmtapi.h)

[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。

SnmpMgrClose 関数は、指定されたセッションに関連付けられている通信ソケットとデータ構造を閉じます。 この関数は、SNMP Management API の要素です。

構文

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

パラメーター

[in] session

閉じるセッションを指定する内部構造体へのポインター。 詳細については、「解説」を参照してください。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

この関数は、Windows ソケットのエラー コードを返す場合があります。

注釈

Windows Server 2003: SNMP マネージャー アプリケーションは、SNMPMgrClose を NULL セッション パラメーターと共に呼び出して、SnmpMgrTrapListen 関数の正常な呼び出しに関連付けられているリソースをクリーンできます。 ただし、アプリケーションが DLL の場合は、DllMain エントリ ポイント関数から SnmpMgrClose を呼び出さないでください。

アプリケーション DLL がアンロード中の場合は、SnmpMgrClose を呼び出さないでください。

Windows Server 2003: SnmpMgrClose は、Windows 2000 での同一の呼び出しと比較して、Windows Server 2003 での実行に時間がかかります。 具体的には、この API の呼び出しが Windows Server 2003 で実行されるまでに最大 1 秒かかりますが、同じ呼び出しは Windows 2000 では約 3 ミリ秒かかります。 これにより、 SnmpMgrOpen と SnmpMgrClose を頻繁に呼び出す Windows Server 2003 SNMP アプリケーションのパフォーマンスの問題が発生する可能性があります。

この問題に対処するには、アプリケーションの起動時にローカル ホストで SnmpMgrOpen を呼び出して追加の SNMP マネージャー セッションを作成し、アプリケーションの有効期間中は開いたままにします。 セッション マネージャーを閉じると、関連付けられているすべてのセッションが閉じられ、 SnmpMgrClose への呼び出しが 1 回だけ必要になります。

Windows Server 2003 SP1: 上記の問題は、Windows 2003 Service Pack 1 には適用されません。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mgmtapi.h
Library	Mgmtapi.lib
[DLL]	Mgmtapi.dll

こちらもご覧ください

SNMP 関数

簡易ネットワーク管理プロトコル (SNMP) の概要

SnmpMgrOpen

SnmpMgrRequest