SnmpExtensionMonitor 関数 (snmp.h)
[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
Microsoft SNMP サービスは SnmpExtensionMonitor 関数を呼び出して、サービスの内部カウンターとパラメーターを表示するビューを SNMP 拡張機能エージェントに提供します。 この関数は、SNMP 拡張エージェント API の要素です。
SnmpExtensionMonitor 関数は省略可能です。 拡張エージェントは、RFC 1213「TCP/IP ベースのインターネットのネットワーク管理のための管理情報ベース: MIB-II」で定義されているように、SNMP サービスの内部管理オブジェクトのビューに関心がある場合は、 関数を実装する必要があります。
構文
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
パラメーター
[in] pAgentMgmtData
AsnAny オブジェクト (構造体) の配列へのポインター。 オブジェクトの数、および各オブジェクトの型と説明は、RFC 1213 に従います。 詳細については、「解説」を参照してください。
戻り値
SNMP 拡張エージェントが pAgentMgmtData パラメーターの値を処理しているときに予期しないエラーが発生しない限り、拡張エージェントは TRUE を返す必要があります。 拡張エージェントが FALSE を返した場合、SNMP サービスは拡張エージェントを読み込まず、サービスは拡張エージェントへの SNMP 要求の送信を停止します。
注釈
拡張機能エージェントが SnmpExtensionMonitor 関数をエクスポートする場合、サービスが SnmpExtensionInit 関数と SnmpExtensionInitEx 関数を呼び出した直後に、拡張機能エージェントの初期化中 に SNMP サービスによって関数が呼び出されます。
SNMP サービスは、 pAgentMgmtData パラメーターが指す配列内の SNMP カウンター (snmpInPkts および snmpOutNoSuchNames カウンターなど) を動的に更新します。 SNMP サービスの実行中にこれらの値を読み取ることができるように、拡張エージェントは pAgentMgmtData へのポインターを格納する必要があります。
SNMP 拡張エージェントは 、pAgentMgmtData パラメーターが指すメモリを更新しないように注意してください。 これは、SNMP サービスの内部カウンターの値が無効になり、SNMP サービスの動作が予測不能になる可能性があるためです。 拡張エージェントが変更しない限り、SNMP サービスの実行中に pAgentMgmtData が指すメモリは有効です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | snmp.h |