Delen via

SNMP-functies

  • Artikel

[SNMP is beschikbaar voor gebruik in de besturingssystemen die zijn opgegeven in de sectie Vereisten. Het kan in volgende versies worden gewijzigd of niet beschikbaar zijn. Gebruik in plaats daarvan Windows Remote Management, de Microsoft-implementatie van WS-Man.]

In dit onderwerp worden drie groeperingen van SNMP-functies beschreven en worden de functies vermeld die in elke groep zijn opgenomen:

API-functies voor SNMP-extensieagent

De functies van de SNMP-extensieagent definiëren de interface tussen de SNMP-service en de SNMP-extensieagent-DLL's van derden. De volgende tabel bevat functies die toepassingen kunnen gebruiken om variabelenbindingen op te lossen die zijn opgegeven door binnenkomende SNMP-protocolgegevenseenheden (PDU's).

API-functie voor SNMP-extensieagent Beschrijving
SnmpExtensionClose- Vraagt of de SNMP-extensieagent de toewijzing van resources ongedaan maakt en bewerkingen beëindigt.
SnmpExtensionInit Initialiseert de DLL van de SNMP-extensieagent.
SnmpExtensionInitEx Identificeert eventuele aanvullende MIB-substructuren (Management Information Base) die door de SNMP-extensieagent worden ondersteund.
SnmpExtensionMonitor Biedt de SNMP-extensieagent informatie over de interne tellers en parameters van de service.
SnmpExtensionQuery- Hiermee worden SNMP-aanvragen opgelost die variabelen bevatten in een of meer van de geregistreerde MIB-substructuren van de SNMP-extensieagent.
SnmpExtensionQueryEx- Verwerkt SNMP-aanvragen die variabelen opgeven in een of meer MIB-substructuren die zijn geregistreerd door SNMP-extensieagents.
SnmpExtensionTrap Haalt informatie op die de service nodig heeft om traps te genereren voor de SNMP-extensieagent.

 

SNMP Management-API-functies

De SNMP-beheerfuncties definiëren de interface tussen SNMP-beheertoepassingen van derden en de DLL-Mgmtapi.dll(Dynamic Link Library) voor beheerfuncties. Het DLL-bestand werkt in combinatie met de SNMP-trapservice (Snmptrap.exe) en kan communiceren met een of meer SNMP-beheertoepassingen van derden. De volgende tabel bevat de beheerfuncties die door externe beheertoepassingen worden gebruikt om SNMP-beheerbewerkingen uit te voeren.

SNMP Management-API-functie Beschrijving
SnmpMgrClose- Hiermee sluit u de communicatiesockets en gegevensstructuren die zijn gekoppeld aan de opgegeven sessie.
SnmpMgrCtl- Hiermee stelt u een operationele parameter in die is gekoppeld aan een SNMP-sessie.
SnmpMgrGetTrap- Retourneert openstaande trapgegevens die de beller niet heeft ontvangen als trap-ontvangst is ingeschakeld.
SnmpMgrGetTrapEx- Retourneert openstaande trapgegevens die de beller niet heeft ontvangen als trap-ontvangst is ingeschakeld. Retourneert ook het adres van de transportbron en de communityval die aan de val is gekoppeld.
SnmpMgrOidToStr- Converteert een interne object-id-structuur naar de tekenreeksweergave.
SnmpMgrOpen Initialiseert communicatiesockets en gegevensstructuren die nodig zijn om communicatie met de SNMP-agent tot stand te brengen.
SnmpMgrRequest- Aanvragen dat de opgegeven bewerking wordt uitgevoerd door de opgegeven agent.
SnmpMgrStrToOid- Converteert de tekenreeksindeling van een object-id naar de structuur van de interne object-id.
SnmpMgrTrapListen Registreert de mogelijkheid van een SNMP-beheertoepassing voor het ontvangen van SNMP-traps van de SNMP Trap Service.

 

API-functies voor SNMP Utility

De SNMP-hulpprogrammafuncties bieden mogelijkheden die nuttig zijn tijdens de ontwikkeling van SNMP-toepassingen, waaronder het vereenvoudigen van de manipulatie van SNMP-gegevensstructuren. De volgende tabel bevat de functies van het SNMP-hulpprogramma.

Api-functie voor SNMP Utility Beschrijving
SnmpSvcGetUptime- Haalt de tijd, in centiseconden, op waarvoor de SNMP-service wordt uitgevoerd.
SnmpSvcSetLogLevel- Hiermee past u het detailniveau van de foutopsporingsuitvoer van de SNMP-service en van SNMP-extensieagents aan.
SnmpSvcSetLogType Hiermee past u de bestemming aan voor de foutopsporingsuitvoer van de SNMP-service en van SNMP-extensieagents.
SnmpUtilAsnAnyCpy- Kopieert een bron-AsnAny--structuur naar een doel AsnAny-structuur.
SnmpUtilAsnAnyFree- Hiermee wordt het geheugen vrijgemaakt dat is toegewezen voor een opgegeven AsnAny structuur.
SnmpUtilDbgPrint- Hiermee stelt u het niveau van foutopsporingsgegevens in dat moet worden ontvangen van de SNMP-service of van een aanroep naar SnmpUtilDbgPrint-.
SnmpUtilIdsToA- Converteert een object-id (OID) naar een tekenreeks die door null is beëindigd.
SnmpUtilMemAlloc- Wijst dynamisch geheugen toe vanuit de proces-heap.
SnmpUtilMemFree- Hiermee wordt het opgegeven geheugenobject vrijgemaakt.
SnmpUtilMemReAlloc- Hiermee wijzigt u de grootte van het opgegeven geheugenobject.
SnmpUtilOctetsCmp- Vergelijkt twee octettekenreeksen.
SnmpUtilOctetsCpy- Kopieert een bron-AsnOctetString--structuur naar een doel AsnOctetString structuur.
SnmpUtilOctetsFree Hiermee wordt het geheugen vrijgemaakt dat is toegewezen voor de opgegeven octettekenreeks.
SnmpUtilOctetsNCmp- Hiermee wordt een vergelijking uitgevoerd van twee octettekenreeksen met het opgegeven aantal subidentifiers.
SnmpUtilOidAppend- Voegt een bronobject-id, die is opgenomen in een AsnObjectIdentifier structuur, toe aan een doelobject-id.
SnmpUtilOidCmp- Vergelijkt twee object-id's die zijn opgenomen in AsnObjectIdentifier structuren.
SnmpUtilOidCpy- Kopieert een bron AsnObjectIdentifier structuur naar een doel AsnObjectIdentifier structuur.
SnmpUtilOidFree Hiermee wordt het geheugen vrijgemaakt dat is toegewezen voor de opgegeven object-id.
SnmpUtilOidNCmp- Vergelijkt twee object-id's die zijn opgenomen in AsnObjectIdentifier structuren met het opgegeven aantal subidentifiers.
SnmpUtilOidToA- Converteert een object-id (OID) naar een tekenreeks die door null is beëindigd.
SnmpUtilPrintAsnAny- Hiermee wordt een waarde afgedrukt die is opgenomen in een AsnAny- structuur voor foutopsporing en ontwikkelingsdoeleinden.
SnmpUtilPrintOid- Hiermee wordt de opgegeven object-id (OID) opgemaakt en wordt het resultaat afgedrukt op het standaarduitvoerapparaat.
SnmpUtilVarBindCpy- Kopieert een bron SnmpVarBind structuur naar een doel SnmpVarBind structuur.
SnmpUtilVarBindListCpy- Kopieert een bron-SnmpVarBindList structuur naar een doel SnmpVarBindList structuur.
SnmpUtilVarBindFree- Maakt het geheugen vrij dat is toegewezen voor de opgegeven SnmpVarBind structuur.
SnmpUtilVarBindListFree Hiermee wordt het geheugen vrijgemaakt dat is toegewezen voor de opgegeven SnmpVarBindList structuur.