SNMP 関数
[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは、変更または使用できない場合があります。 代わりに、Windows リモート管理 使用します。これは、WS-Man の Microsoft 実装です。
このトピックでは、SNMP 関数の 3 つのグループについて説明し、各グループに含まれる関数の一覧を示します。
- SNMP 拡張エージェント API 関数の の
- SNMP Management API Functions
- SNMP ユーティリティ API 関数の
SNMP 拡張エージェント API 関数
SNMP 拡張エージェント関数は、SNMP サービスとサードパーティの SNMP 拡張エージェント DLL の間のインターフェイスを定義します。 次の表に、アプリケーションが受信 SNMP プロトコル データ ユニット (PDU) で指定された変数バインドを解決するために使用できる関数を示します。
| SNMP 拡張エージェント API 関数 | 形容 |
|---|---|
| SnmpExtensionClose | SNMP 拡張エージェントがリソースの割り当てを解除し、操作を終了することを要求します。 |
| SnmpExtensionInitの | SNMP 拡張エージェント DLL を初期化します。 |
| SnmpExtensionInitExの | SNMP 拡張エージェントがサポートする追加の管理情報ベース (MIB) サブツリーを識別します。 |
| SnmpExtensionMonitor | SNMP 拡張エージェントに、サービスの内部カウンターとパラメーターに関する情報を提供します。 |
| SnmpExtensionQueryの | SNMP 拡張エージェントの 1 つ以上の登録済み MIB サブツリーに変数を含む SNMP 要求を解決します。 |
| SnmpExtensionQueryExの | SNMP 拡張エージェントによって登録される 1 つ以上の MIB サブツリー内の変数を指定する SNMP 要求を処理します。 |
| SnmpExtensionTrapの | SNMP 拡張エージェントのトラップを生成するためにサービスが必要とする情報を取得します。 |
SNMP Management API 関数
SNMP 管理機能は、サードパーティの SNMP マネージャー アプリケーションと管理機能ダイナミック リンク ライブラリ (DLL) Mgmtapi.dll間のインターフェイスを定義します。 DLL は、SNMP トラップ サービス (Snmptrap.exe) と連携して動作し、1 つ以上のサードパーティ SNMP マネージャー アプリケーションと対話できます。 次の表に、サードパーティのマネージャー アプリケーションが SNMP マネージャー操作を実行するために使用する管理機能を示します。
| SNMP Management API 関数 | 形容 |
|---|---|
| SnmpMgrClose | 指定したセッションに関連付けられている通信ソケットとデータ構造を閉じます。 |
| SnmpMgrCtl | SNMP セッションに関連付けられている操作パラメーターを設定します。 |
| SnmpMgrGetTrap | トラップ受信が有効になっている場合に呼び出し元が受信していない未処理のトラップ データを返します。 |
| SnmpMgrGetTrapEx | トラップ受信が有効になっている場合に呼び出し元が受信していない未処理のトラップ データを返します。 また、トランスポート ソースのアドレスと、トラップに関連付けられているコミュニティ トラップも返します。 |
| SnmpMgrOidToStr | 内部オブジェクト識別子構造体を文字列形式に変換します。 |
| SnmpMgrOpen | SNMP エージェントとの通信を確立するために必要な通信ソケットとデータ構造を初期化します。 |
| SnmpMgrRequestの | 指定したエージェントが指定した操作を実行することを要求します。 |
| SnmpMgrStrToOidの | オブジェクト識別子の文字列形式を内部オブジェクト識別子構造体に変換します。 |
| SnmpMgrTrapListen | SNMP トラップ サービスから SNMP トラップを受信する SNMP マネージャー アプリケーションの機能を登録します。 |
SNMP ユーティリティ API 関数
SNMP ユーティリティー機能は、SNMP データ構造の操作の簡素化など、SNMP アプリケーションの開発時に役立つ機能を提供します。 次の表に、SNMP ユーティリティの機能を示します。
| SNMP ユーティリティ API 関数 | 形容 |
|---|---|
| SnmpSvcGetUptimeの | SNMP サービスが実行されている時刻を 1 セント単位で取得します。 |
| SnmpSvcSetLogLevelの | SNMP サービスおよび SNMP 拡張エージェントからのデバッグ出力の詳細レベルを調整します。 |
| SnmpSvcSetLogType | SNMP サービスおよび SNMP 拡張エージェントからのデバッグ出力の宛先を調整します。 |
| SnmpUtilAsnAnyCpyの | AsnAny構造体コピー元を、AsnAny 構造体 コピー先にコピーします。 |
| SnmpUtilAsnAnyFree | 指定した AsnAny 構造体に割り当てられたメモリを解放します。 |
| SnmpUtilDbgPrintの | SNMP サービスまたは SnmpUtilDbgPrintの呼び出しから受信するデバッグ情報のレベルを設定します。 |
| SnmpUtilIdsToAの | オブジェクト識別子 (OID) を null で終わる文字列に変換します。 |
| SnmpUtilMemAllocの | プロセス ヒープから動的メモリを割り当てます。 |
| SnmpUtilMemFree | 指定したメモリ オブジェクトを解放します。 |
| SnmpUtilMemReAllocの | 指定したメモリ オブジェクトのサイズを変更します。 |
| SnmpUtilOctetsCmpの | 2 つのオクテット文字列を比較します。 |
| SnmpUtilOctetsCpyの | AsnOctetString構造体コピー元をコピー先 AsnOctetString 構造体にコピーします。 |
| SnmpUtilOctetsFree | 指定したオクテット文字列に割り当てられたメモリを解放します。 |
| SnmpUtilOctetsNCmpの | 指定した数のサブ識別子との 2 オクテット文字列の比較を実行します。 |
| SnmpUtilOidAppendの | AsnObjectIdentifier 構造体に含まれるソース オブジェクト識別子をコピー先オブジェクト識別子に追加します。 |
| SnmpUtilOidCmpの | AsnObjectIdentifier 構造体に含まれる 2 つのオブジェクト識別子を比較します。 |
| SnmpUtilOidCpyの | AsnObjectIdentifier構造体コピー元を、AsnObjectIdentifier 構造体 コピー先にコピーします。 |
| SnmpUtilOidFreeをする | 指定したオブジェクト識別子に割り当てられたメモリを解放します。 |
| SnmpUtilOidNCmpの | AsnObjectIdentifier 構造体に含まれる 2 つのオブジェクト識別子を、指定した数のサブ識別子と比較します。 |
| SnmpUtilOidToAの | オブジェクト識別子 (OID) を null で終わる文字列に変換します。 |
| SnmpUtilPrintAsnAny | デバッグおよび開発のために、AsnAny 構造体に含まれる値を出力します。 |
| SnmpUtilPrintOid | 指定したオブジェクト識別子 (OID) を書式設定し、結果を標準出力デバイスに出力します。 |
| SnmpUtilVarBindCpyの | SnmpVarBind構造体ソースを SnmpVarBind 構造体 コピー先にコピーします。 |
| SnmpUtilVarBindListCpyの | SnmpVarBindList構造体ソースを SnmpVarBindList 構造体 コピー先にコピーします。 |
| SnmpUtilVarBindFree | 指定した SnmpVarBind 構造体に割り当てられたメモリを解放します。 |
| SnmpUtilVarBindListFreeの | 指定した SnmpVarBindList 構造体に割り当てられたメモリを解放します。 |