SnmpCountVbl-Funktion (winsnmp.h)

  • Artikel

[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.]

Eine WinSNMP-Anwendung ruft die WinSNMP-Funktion SnmpCountVbl auf, um die Variablenbindungseinträge in der angegebenen Variablenbindungsliste aufzulisten.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpCountVbl(
  [in] HSNMP_VBL vbl
);

Parameter

[in] vbl

Handle mit der Liste der Variablenbindungen, die aufgelistet werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Variablenbindungseinträge in der Liste der Variablenbindungen.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Um erweiterte Fehlerinformationen abzurufen, rufen Sie SnmpGetLastError auf, indem Sie einen NULL-Wert im Sitzungsparameter angeben. 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 Speicherzuordnung ist ein Fehler aufgetreten.
SNMPAPI_NOOP
 Die Liste der Variablenbindungen enthält derzeit keine Variablenbindungseinträge.
SNMPAPI_VBL_INVALID
 Der vbl-Parameter ist ungültig.
SNMPAPI_OTHER_ERROR
 Ein unbekannter oder nicht definierter Fehler ist aufgetreten.

Hinweise

Die SnmpCountVbl-Funktion gibt einen ganzzahligen Wert ohne Vorzeichen zurück, der der Maximalwert ist, den die WinSNMP-Anwendung für den Indexparameter in den Funktionen SnmpGetVb, SnmpSetVb und SnmpDeleteVb angeben kann.

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

SnmpDeleteVb

SnmpGetVb

SnmpSetVb

WinSNMP-Funktionen

Übersicht über die WinSNMP-API