SnmpMgrOpen-Funktion (mgmtapi.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 SnmpMgrOpen-Funktion initialisiert Kommunikationssockets und Datenstrukturen und ermöglicht die Kommunikation mit dem angegebenen SNMP-Agent. Diese Funktion ist ein Element der SNMP-Verwaltungs-API.
Syntax
LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
[in] LPSTR lpAgentAddress,
[in] LPSTR lpAgentCommunity,
[in] INT nTimeOut,
[in] INT nRetries
);
Parameter
[in] lpAgentAddress
Zeiger auf eine NULL-endende Zeichenfolge, die einen Hostnamen oder eine IP-Adresse angibt. Der Hostname muss in eine IP-Adresse, eine IPX-Adresse (in 8.12-Notation) oder eine Ethernet-Adresse aufgelöst werden. Die zulässigen Formulare für Hostnamen und IP-Adressen finden Sie im Abschnitt Hinweise.
[in] lpAgentCommunity
Zeiger auf eine null-endende Zeichenfolge, die den SNMP-Communitynamen angibt, der bei der Kommunikation mit dem Agent verwendet werden soll, der durch den lpAgentAddress-Parameter identifiziert wird.
[in] nTimeOut
Gibt das Kommunikationstimeout in Millisekunden an.
[in] nRetries
Gibt die Anzahl der Wiederholungsversuche für die Kommunikation an. Das im nTimeOut-Parameter angegebene Timeout wird bei jeder Übertragung eines Wiederholungsversuchs verdoppelt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine LPSNMP_MGR_SESSION-Struktur . Diese Struktur wird intern verwendet, und der Programmierer sollte sie nicht ändern. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise den SNMP_MEM_ALLOC_ERROR Fehlercode zurück, der auf einen Speicherbelegungsfehler hinweist.
Diese Funktion gibt möglicherweise auch Windows Sockets-Fehlercodes zurück.
Hinweise
Verwenden Sie nach Möglichkeit einen Hostnamen, um den SNMP-Agent im lpAgentAddress-Parameter zu identifizieren. Hostnamen können nur für Agents bereitgestellt werden, wenn TCP/IP geladen wird und die Namen TCP/IP-Hostnamen sind. NetBIOS-Namen können nicht für IPX-Hosts angegeben werden.
Name und Adresse des SNMP-Ziels oder die Zeichenfolge, auf die der parameter lpAgentAddress verweist, sollten einem der folgenden Formulare entsprechen.
| Name/Adresse | Formular (Beispiel) |
|---|---|
| Hostname | merlin oder merlin.microsoft.com |
| IPv4-Adresse | 157.57.8.160 |
| IPv6-Adresse | 3ffe:8311:ffff::b3ff:fe88:c33 |
| MAC-Adresse | 00aa00bbccddd |
| IPX-Adresse | 00006112.00aa00bbccdd |
Anwendungen sollten nicht den LPSNMP_MGR_SESSION zeiger verwenden, der von dieser Funktion zurückgegeben wird, um die SnmpMgrRequest-Funktion im Kontext eines anderen Threads aufzurufen.
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 |