SnmpGetTranslateMode 関数 (winsnmp.h)

[アーティクル]
03/13/2024

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

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

構文

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTranslateMode(
  [out] smiLPUINT32 nTranslateMode
);

パラメーター

[out] nTranslateMode

Microsoft WinSNMP 実装で有効なエンティティとコンテキスト変換モードを受け取る符号なし long 整数変数へのポインター。このパラメーターには、次の値のいずれかを指定できます。

値	意味
SNMPAPI_TRANSLATED	実装では、そのデータベースを使用して、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。 SnmpGetTranslateMode が失敗した場合、nTranslateMode パラメーターの値はアプリケーションにとって意味がありません。拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。

リターンコード	説明
SNMPAPI_NOT_INITIALIZED	SnmpStartup 関数が正常に完了しませんでした。
SNMPAPI_ALLOC_ERROR	メモリ割り当て中にエラーが発生しました。
SNMPAPI_OTHER_ERROR	不明または未定義のエラーが発生しました。

注釈

エンティティ変換モードとコンテキスト変換モードは、 SnmpStrToEntity、 SnmpStrToContext、 SnmpContextToStr 、 SnmpEntityToStr 関数の呼び出しに影響します。詳細については、「エンティティとコンテキスト変換モードの設定」を参照してください。

要件

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