SnmpMgrRequest-Funktion (mgmtapi.h)

Artikel
08/24/2023

[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 SnmpMgrRequest-Funktion fordert an, dass der angegebene Vorgang mit dem angegebenen Agent ausgeführt wird. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.

Syntax

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

Parameter

[in] session

Zeiger auf eine interne Struktur, die die Sitzung angibt, die die Anforderung ausführt.

Anwendungen sollten nicht den LPSNMP_MGR_SESSION-Zeiger angeben, der von dieser Funktion in einem anderen Thread zurückgegeben wird. Sie können einen von SnmpMgrOpen zurückgegebenen Zeiger angeben, aber nur, wenn die Aufrufe von SnmpMgrOpen und SnmpMgrRequest aus dem Kontext desselben Threads stammen.

[in] requestType

Gibt den SNMP-Anforderungstyp an. Dieser Parameter kann einer der folgenden Werte sein, die von SNMPv1 definiert werden.

Wert	Bedeutung
SNMP_PDU_GET	Rufen Sie den Wert oder die Werte der angegebenen Variablen ab.
SNMP_PDU_GETNEXT	Rufen Sie den Wert oder die Werte des lexikografischen Nachfolgers der angegebenen Variablen ab.
SNMP_PDU_SET	Schreiben sie einen Wert innerhalb einer bestimmten Variablen.

Beachten Sie, dass PDU-Anforderungstypen umbenannt wurden. Weitere Informationen finden Sie unter SNMP-Variablentypen und Anforderungs-PDU-Typen.

[in, out] variableBindings

Zeiger auf die Variablenbindungsliste.

Hinweis Das SnmpVarBind-Array , auf das von der SnmpVarBindList-Struktur verwiesen wird, muss mithilfe der SnmpUtilMemAlloc-Funktion zugeordnet werden.

[out] errorStatus

Zeiger auf eine Variable, in der der Fehler status Ergebnis zurückgegeben wird. Dieser Parameter kann einer der folgenden Werte sein, die von SNMPv1 definiert werden.

Wert	Bedeutung
SNMP_ERRORSTATUS_NOERROR	Der Agent meldet, dass während der Übertragung keine Fehler aufgetreten sind.
SNMP_ERRORSTATUS_TOOBIG	Der Agent konnte die Ergebnisse des angeforderten Vorgangs nicht in einer einzelnen SNMP-Nachricht platzieren.
SNMP_ERRORSTATUS_NOSUCHNAME	Der angeforderte Vorgang identifizierte eine unbekannte Variable.
SNMP_ERRORSTATUS_BADVALUE	Der angeforderte Vorgang hat versucht, eine Variable zu ändern, aber er hat entweder einen Syntax- oder Wertfehler angegeben.
SNMP_ERRORSTATUS_READONLY	Der angeforderte Vorgang hat versucht, eine Variable zu ändern, die nicht gemäß dem Communityprofil der Variablen geändert werden durfte.
SNMP_ERRORSTATUS_GENERR	Während des angeforderten Vorgangs ist ein anderer Fehler als einer der hier aufgeführten aufgetreten.

[out] errorIndex

Zeiger auf eine Variable, in der das Fehlerindexergebnis zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf, wodurch möglicherweise einer der folgenden Fehlercodes zurückgegeben wird.

Rückgabecode	Beschreibung
SNMP_MGMTAPI_TIMEOUT	Das Anforderungstimeout.
SNMP_MGMTAPI_SELECT_FDERRORS	Unerwartete Fehlerdateideskriptoren, die von der Windows Sockets-Auswahlfunktion angegeben werden.

Hinweise

Wiederholungen und Timeouts werden für die SnmpMgrOpen-Funktion bereitgestellt. Jede Variable in der Variablenbindungsliste muss initialisiert werden, um ASN_NULL für Get- und Get Next-Anforderungen einzugeben.

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	mgmtapi.h
Bibliothek	Mgmtapi.lib
DLL	Mgmtapi.dll

Weitere Informationen

SNMP-Funktionen

Simple Network Management-Protokoll (SNMP) – Übersicht

SnmpMgrClose

SnmpMgrOpen

Freigeben über