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 rozhraní API pro správu protokolu SNMP
- funkce rozhraní API nástroje SNMP
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. |