SnmpSetTranslateMode-Funktion (winsnmp.h)

Artikel
03/06/2024

[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die WinSNMP SnmpSetTranslateMode-Funktion ermöglicht es einer WinSNMP-Anwendung, den Entitäts- und Kontextübersetzungsmodus zu ändern. Der Entitäts- und Kontextübersetzungsmodus wirkt sich auf die Interpretation und Rückgabe von WinSNMP-Eingabe- und Ausgabezeichenfolgenparametern aus.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

Parameter

[in] nTranslateMode

Gibt einen Wert für den neuen Entitäts- und Kontextübersetzungsmodus an. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
SNMPAPI_TRANSLATED	Die Microsoft WinSNMP-Implementierung verwendet ihre Datenbank, um benutzerfreundliche Namen für SNMP-Entitäten und verwaltete Objekte zu übersetzen. Die Implementierung übersetzt sie in ihre SNMPv1- oder SNMPv2C-Komponenten.
SNMPAPI_UNTRANSLATED_V1	Die Implementierung interpretiert SNMP-Entitätsparameter als SNMP-Transportadressen und Kontextparameter als SNMP-Communityzeichenfolgen. Für SNMPv2-Zielentitäten erstellt die Implementierung ausgehende SNMP-Nachrichten, die den Wert null im Versionsfeld enthalten.
SNMPAPI_UNTRANSLATED_V2	Die Implementierung interpretiert SNMP-Entitätsparameter als SNMP-Transportadressen und Kontextparameter als SNMP-Communityzeichenfolgen. Für SNMPv2-Zielentitäten erstellt die Implementierung ausgehende SNMP-Nachrichten, die den Wert 1 im Versionsfeld enthalten.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Um erweiterte Fehlerinformationen abzurufen, rufen Sie SnmpGetLastError auf, indem Sie einen NULL-Wert im Sitzungsparameter angeben. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.

Rückgabecode	Beschreibung
SNMPAPI_NOT_INITIALIZED	Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR	Während der Speicherzuordnung ist ein Fehler aufgetreten.
SNMPAPI_MODE_INVALID	Die Implementierung unterstützt den angeforderten Übersetzungsmodus nicht.
SNMPAPI_OTHER_ERROR	Ein unbekannter oder nicht definierter Fehler ist aufgetreten.

Hinweise

Der neue Entitäts- und Kontextübersetzungsmodus wirkt sich auf nachfolgende Aufrufe der Funktionen SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr und SnmpEntityToStr aus. Die WinSNMP-Anwendung kann den Entitäts- und Kontextübersetzungsmodus erneut ändern, indem sie snmpSetTranslateMode mit einem anderen nTranslateMode-Wert erneut aufruft .

Weitere Informationen finden Sie unter Festlegen des Entitäts- und Kontextübersetzungsmodus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsnmp.h
Bibliothek	Wsnmp32.lib
DLL	Wsnmp32.dll