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.