Sdílet prostřednictvím


Funkce SNMP

[PROTOKOL SNMP je k dispozici pro použití v operačních systémech uvedených v části Požadavky. V následujících verzích může být změněna nebo nedostupná. Místo toho použijte vzdálenou správu systému Windows, což je implementace WS-Man od Microsoftu.]

Toto téma popisuje tři seskupení funkcí SNMP a uvádí funkce, které jsou součástí každé skupiny:

Funkce rozhraní API agenta rozšíření SNMP

Funkce agenta rozšíření SNMP definují rozhraní mezi službou SNMP a knihovnou DLL agenta rozšíření SNMP třetí strany. Následující tabulka uvádí funkce, které mohou aplikace použít k překladu proměnných vazeb určených datovými jednotkami příchozího protokolu SNMP (PDU).

Funkce rozhraní API agenta rozšíření SNMP Popis
SnmpExtensionClose Vyžaduje, aby agent rozšíření SNMP zrušil přidělení prostředků a ukončuje operace.
snmpExtensionInit Inicializuje knihovnu DLL agenta rozšíření SNMP.
SnmpExtensionInitEx Identifikuje všechny další podstromy databáze informací o správě (MIB), které agent rozšíření SNMP podporuje.
SnmpExtensionMonitor Poskytuje agenta rozšíření SNMP informace o interních čítačích a parametrech služby.
snmpExtensionQuery Řeší požadavky SNMP, které obsahují proměnné v jednom nebo několika registrovaných podstromech MIB agenta rozšíření SNMP.
SnmpExtensionQueryEx Zpracovává požadavky SNMP, které určují proměnné v jednom nebo více podstromech MIB registrovaných agenty rozšíření SNMP.
SnmpExtensionTrap Načte informace, které služba vyžaduje k vygenerování depeší pro agenta rozšíření SNMP.

 

Funkce rozhraní API pro správu SNMP

Funkce správy PROTOKOLU SNMP definují rozhraní mezi aplikacemi správce SNMP třetích stran a knihovnou DLL (Dynamic-Link Library) funkce správy Mgmtapi.dll. Knihovna DLL funguje ve spojení se službou depeše SNMP (Snmptrap.exe) a může pracovat s jednou nebo více aplikacemi správce SNMP třetích stran. Následující tabulka uvádí funkce správy, které aplikace správce třetích stran používají k provádění operací správce SNMP.

Funkce rozhraní API pro správu SNMP Popis
SnmpMgrClose Zavře komunikační sokety a datové struktury, které jsou přidružené k zadané relaci.
snmpMgrCtl Nastaví provozní parametr přidružený k relaci SNMP.
snmpmgrGetTrap Vrátí nevyrovnaná data soutisku, která volající nepřijal, pokud je povolen příjem soutisku.
SnmpMgrGetTrapEx Vrátí nevyrovnaná data soutisku, která volající nepřijal, pokud je povolen příjem soutisku. Vrátí také adresu zdroje přenosu a pasti komunity, která je přidružena k pasti.
SnmpMgrOidToStr Převede interní strukturu identifikátoru objektu na řetězcové vyjádření.
SnmpMgrOpen Inicializuje komunikační sokety a datové struktury potřebné k navázání komunikace s agentem SNMP.
SnmpMgrRequest Vyžaduje, aby zadaná operace byla provedena zadaným agentem.
SnmpMgrStrToOid Převede formát řetězce identifikátoru objektu na jeho interní strukturu identifikátoru objektu.
SnmpMgrTrapListen Zaregistruje schopnost aplikace správce SNMP přijímat depeše SNMP ze služby depeše SNMP.

 

Funkce rozhraní API nástroje SNMP

Funkce nástroje SNMP poskytují funkce, které jsou užitečné při vývoji aplikací SNMP, včetně zjednodušení manipulace s datovými strukturami SNMP. Následující tabulka uvádí funkce nástroje SNMP.

Funkce rozhraní API nástroje SNMP Popis
snmpSvcGetUptime Načte čas v centisekundách, pro který je služba SNMP spuštěná.
SnmpSvcSetLogLevel Upraví úroveň podrobností výstupu ladění ze služby SNMP a agentů rozšíření SNMP.
SnmpSvcSetLogType Upraví cíl pro výstup ladění ze služby SNMP a z agentů rozšíření SNMP.
SnmpUtilAsnAnyCpy Zkopíruje zdrojovou strukturu AsnAny do cílové struktury AsnAny.
SnmpUtilAsnAnyFree Uvolní paměť přidělenou pro zadanou strukturu AsnAny.
SnmpUtilDbgPrint Nastaví úroveň informací o ladění, které se mají přijímat ze služby SNMP nebo z volání SnmpUtilDbgPrint.
SnmpUtilIdsToA Převede identifikátor objektu (OID) na řetězec ukončený hodnotou null.
snmpUtilMemAlloc Přidělí dynamickou paměť z haldy procesu.
SnmpUtilMemFree Uvolní zadaný objekt paměti.
SnmpUtilMemReAlloc Změní velikost zadaného objektu paměti.
SnmpUtilOctetsCmp Porovná dva řetězce oktetů.
SnmpUtilOctetsCpy Zkopíruje zdrojovou strukturu AsnOctetString do cílové struktury AsnOctetString.
SnmpUtilOctetsFree Uvolní paměť přidělenou pro zadaný řetězec oktetu.
SnmpUtilOctetsNCmp Provede porovnání dvou osmičkových řetězců se zadaným počtem podidentifikátorů.
SnmpUtilOidAppend Připojí identifikátor zdrojového objektu, který je součástí AsnObjectIdentifier struktury, k identifikátoru cílového objektu.
snmputilOidCmp Porovná dva identifikátory objektů obsažené v AsnObjectIdentifier struktury.
SnmpUtilOidCpy Zkopíruje zdrojovou strukturu AsnObjectIdentifier do cílové struktury AsnObjectIdentifier.
SnmpUtilOidFree Uvolní paměť přidělenou pro zadaný identifikátor objektu.
snmpUtilOidNCmp Porovná dva identifikátory objektů obsažené v AsnObjectIdentifier struktury se zadaným počtem podidentifikátorů.
snmpUtilOidToA Převede identifikátor objektu (OID) na řetězec ukončený hodnotou null.
SnmpUtilPrintAsnAny Vytiskne hodnotu obsaženou ve struktuře AsnAny pro účely ladění a vývoje.
SnmpUtilPrintOid Naformátuje zadaný identifikátor objektu (OID) a vytiskne výsledek do standardního výstupního zařízení.
SnmpUtilVarBindCpy Zkopíruje zdrojovou strukturu SnmpVarBind do cílové struktury SnmpVarBind.
SnmpUtilVarBindListCpy Zkopíruje zdrojovou strukturu SnmpVarBindList do cílové struktury SnmpVarBindList.
SnmpUtilVarBindFree Uvolní paměť přidělenou pro zadanou SnmpVarBind strukturu.
SnmpUtilVarBindListFree Uvolní paměť přidělenou pro zadanou SnmpVarBindList struktury.