SnmpSetTranslateMode 関数 (winsnmp.h)

[アーティクル]
08/27/2023

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

WinSNMP SnmpSetTranslateMode 関数を使用すると、WinSNMP アプリケーションでエンティティとコンテキスト変換モードを変更できます。エンティティ変換モードとコンテキスト変換モードは、WinSNMP 入力および出力文字列パラメーターの解釈と戻り値に影響します。

構文

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

パラメーター

[in] nTranslateMode

新しいエンティティとコンテキスト変換モードの値を指定します。このパラメーターには次のいずれかの値を指定する必要があります。

値	意味
SNMPAPI_TRANSLATED	Microsoft WinSNMP 実装では、そのデータベースを使用して、SNMP エンティティとマネージドオブジェクトのわかりやすい名前を変換します。実装では、それらを SNMPv1 または SNMPv2C コンポーネントに変換します。
SNMPAPI_UNTRANSLATED_V1	実装では、SNMP エンティティパラメーターが SNMP トランスポートアドレスとして解釈され、コンテキストパラメーターが SNMP コミュニティ文字列として解釈されます。 SNMPv2 宛先エンティティの場合、実装では、バージョンフィールドに 0 の値を含む送信 SNMP メッセージが作成されます。
SNMPAPI_UNTRANSLATED_V2	実装では、SNMP エンティティパラメーターが SNMP トランスポートアドレスとして解釈され、コンテキストパラメーターが SNMP コミュニティ文字列として解釈されます。 SNMPv2 宛先エンティティの場合、実装では、バージョンフィールドに値 1 を含む送信 SNMP メッセージが作成されます。

戻り値

関数が成功した場合、戻り値はSNMPAPI_SUCCESS。

関数が失敗した場合、戻り値はSNMPAPI_FAILURE。拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。

リターンコード	説明
SNMPAPI_NOT_INITIALIZED	SnmpStartup 関数が正常に完了しませんでした。
SNMPAPI_ALLOC_ERROR	メモリ割り当て中にエラーが発生しました。
SNMPAPI_MODE_INVALID	実装では、要求された翻訳モードはサポートされていません。
SNMPAPI_OTHER_ERROR	不明または未定義のエラーが発生しました。

注釈

新しいエンティティ変換モードとコンテキスト変換モードは、SnmpStrToEntity、SnmpStrToContext、SnmpContextToStr、および SnmpEntityToStr 関数の後続の呼び出しに影響します。 WinSNMP アプリケーションは、別の nTranslateMode 値を使用して SnmpSetTranslateMode を別の呼び出しを行うことで、エンティティとコンテキスト変換モードを再度変更できます。

詳細については、「エンティティとコンテキスト変換モードの設定」を参照してください。

要件

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