Festlegen des Entitäts- und Kontextübersetzungsmodus

Die WinSNMP-Anwendung kann die Interpretation und Übersetzung von Entitäts- und Kontextparametern angeben, indem sie den Entitäts- und Kontextübersetzungsmodus festlegt. Die Microsoft WinSNMP-Implementierung speichert den Modus in einer Datenbank.

Die Einstellung des Entitäts- und Kontextübersetzungsmodus bestimmt die Art und Weise, in der die SnmpStrToEntity-Funktion und die SnmpStrToContext-Funktion Eingabezeichenfolgen interpretieren. Die Einstellung bestimmt auch den Typ der Ausgabezeichenfolge, die die Funktionen SnmpEntityToStr und SnmpContextToStr zurückgeben. Weitere Informationen finden Sie unter Unterstützung für IPX-Adresszeichenfolgen in WinSNMP.

Die Implementierung gibt den aktuellen Standardentitäts- und Kontextübersetzungsmodus im Parameter nTranslateMode der SnmpStartup-Funktion zurück. Um den aktuellen Entitäts- und Kontextübersetzungsmodus abzurufen, der für die Implementierung wirksam ist, kann eine Anwendung die SnmpGetTranslateMode-Funktion jederzeit aufrufen.

Es folgen die gültigen Entitäts- und Kontextübersetzungsmodi.

Mode Bedeutung
SNMPAPI_TRANSLATED Die 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 literale SNMP-Transportadressen und Kontextparameter als literale 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 literale SNMP-Communityzeichenfolgen. Für SNMPv2-Zielentitäten erstellt die Implementierung ausgehende SNMP-Nachrichten, die den Wert 1 im Versionsfeld enthalten.

 

Die Implementierung versucht, Ressourcen in ihrer Datenbank der Literaltransportadresse der Verwaltungsentität zuzuordnen.

Um die Entität und den Kontextübersetzungsmodus zu ändern, muss eine WinSNMP-Anwendung die SnmpSetTranslateMode-Funktion aufrufen. Wenn der angeforderte Übersetzungsmodus ungültig ist, schlägt die Funktion fehl, und SnmpGetLastError gibt den Fehlercode SNMPAPI_MODE_INVALID zurück.