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.
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
);
[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.
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 |
---|---|
|
Der dwCtlCode-Parameter gibt keinen gültigen Steuerelementcode an. |
|
Der Sitzungsparameter gibt keine gültige SNMP-Sitzung an. |
|
Mindestens ein lpvInBuffer-, lpvOutBuffer- oder lpcbBytesRequired-Parameter ist ungültig, oder der cbInBuffer - oder cbOutBuffer-Parameter ist zu klein. |
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 |