SnmpGetTranslateMode-Funktion (winsnmp.h)

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

Die WinSNMP-Funktion SnmpGetTranslateMode gibt die aktuelle Einstellung der Entität und des Kontextübersetzungsmodus an eine WinSNMP-Anwendung zurück. 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 SnmpGetTranslateMode(
  [out] smiLPUINT32 nTranslateMode
);

Parameter

[out] nTranslateMode

Zeiger auf eine variable Lange Ganzzahl ohne Vorzeichen, um den Entitäts- und Kontextübersetzungsmodus zu empfangen, der für die Microsoft WinSNMP-Implementierung wirksam ist. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert 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 SNMP-Transportadressen und Kontextparameter als SNMP-Communityzeichenfolgen. Für SNMPv2-Zielentitäten erstellt die Implementierung ausgehende SNMP-Nachrichten, die den Wert 0 (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 im Versionsfeld den Wert 1 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. Wenn SnmpGetTranslateMode fehlschlägt, hat der Wert des nTranslateMode-Parameters keine Bedeutung für die Anwendung. Rufen Sie SnmpGetLastError auf, um erweiterte Fehlerinformationen zu erhalten, und geben Sie einen NULL-Wert im Sitzungsparameter an. 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 Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_OTHER_ERROR
 Es ist ein unbekannter oder nicht definierter Fehler aufgetreten.

Hinweise

Der Entitäts- und Kontextübersetzungsmodus wirkt sich auf Aufrufe der Funktionen SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr und SnmpEntityToStr aus. 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

Weitere Informationen

SnmpContextToStr

SnmpEntityToStr

SnmpSetTranslateMode

SnmpStartup

SnmpStrToContext

SnmpStrToEntity

WinSNMP-Funktionen

Übersicht über winSNMP-API

  • Last updated on