Auf Englisch lesen

Freigeben über


SnmpMgrCtl-Funktion (mgmtapi.h)

[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 SnmpMgrCtl-Funktion legt einen Betriebsparameter fest, der einer SNMP-Sitzung zugeordnet ist. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.

Syntax

BOOL SNMP_FUNC_TYPE SnmpMgrCtl(
  [in]  LPSNMP_MGR_SESSION session,
  [in]  DWORD              dwCtlCode,
  [in]  LPVOID             lpvInBuffer,
  [in]  DWORD              cbInBuffer,
  [out] LPVOID             lpvOUTBuffer,
  [out] DWORD              cbOUTBuffer,
  [out] LPDWORD            lpcbBytesReturned
);

Parameter

[in] session

Zeiger auf eine interne Struktur, die die Sitzung angibt, für die der Steuerungscode gilt.

[in] dwCtlCode

Gibt einen Wert (einen Steuerelementcode) an, der den auszuführenden Vorgang identifiziert.

Derzeit ist MGMCTL_SETAGENTPORT der einzige unterstützte Steuerelementcode. Durch Festlegen dieses Codes kann eine SNMP-Verwaltungsanwendung Anforderungen an einen Remote-Agent senden, der SNMP-Manageranforderungen an einem beliebigen Port "lauscht". Weitere Informationen finden Sie unter lpvInBuffer und cbInBuffer-Parameterbeschreibungen .

[in] lpvInBuffer

Zeiger auf den Puffer, der die für den Vorgang erforderlichen Eingabeparameter enthält.

Wenn Sie den MGMCTL_SETAGENTPORT-Steuerelementcode angeben, muss dieser Parameter auf eine ganze Zahl ohne Vorzeichen verweisen, die die Portnummer angibt, an der der Remote-Agent auf SNMP-Manager-Anforderungen "lauscht". Die Portnummer muss in host-byte-Reihenfolge angegeben sein.

[in] cbInBuffer

Gibt die Größe des Puffers in Bytes an, auf den der lpvInBuffer-Parameter verweist.

Wenn Sie den MGMCTL_SETAGENTPORT-Steuerelementcode angeben, ist dieser Parameter gleich sizeof(UINT).

[out] lpvOUTBuffer

Zeiger auf den Puffer, der die Ausgabedaten des Vorgangs empfängt.

[out] cbOUTBuffer

Gibt die Größe des Puffers in Bytes an, auf den der lpvOutBuffer-Parameter verweist.

[out] lpcbBytesReturned

Zeiger auf eine Variable, die die tatsächliche Größe der im Puffer gespeicherten Daten in Bytes empfängt, auf die der lpvOutBuffer-Parameter verweist.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError kann auch einen der folgenden Fehlercodes zurückgeben.

Rückgabecode Beschreibung
SNMP_MGMTAPI_INVALID_CTL
Der dwCtlCode-Parameter gibt keinen gültigen Steuerelementcode an.
SNMP_MGMTAPI_INVALID_SESSION
Der Sitzungsparameter gibt keine gültige SNMP-Sitzung an.
SNMP_MGMTAPI_INVALID_BUFFER
Mindestens ein lpvInBuffer-, lpvOutBuffer- oder lpcbBytesRequired-Parameter ist ungültig, oder der cbInBuffer - oder cbOutBuffer-Parameter ist zu klein.

Anforderungen

   
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

SnmpMgrOpen