/* winsnmp.h - Header file for the Windows SNMP API Written by Filip Navara References (2003-08-25): Windows SNMP http://www.winsnmp.com/docs/winsnmp.doc WinSNMP v2.0 Addendum http://www.winsnmp.com/docs/winsnmp2.txt WinSNMP v3.0 API Addendum http://www.winsnmp.com/docs/winsnmp3.htm WinSNMP Reference http://msdn.microsoft.com/library/en-us/snmp/snmp/winsnmp_api_reference.asp This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. */ #ifndef _WINSNMP_H #define _WINSNMP_H #if __GNUC__ >= 3 #pragma GCC system_header #endif #ifndef _WINDOWS_H #include #endif #include #ifndef WINSNMPAPI #define WINSNMPAPI WINAPI #endif #ifdef __cplusplus extern "C" { #endif #define MAXOBJIDSIZE 128 #define MAXOBJIDSTRSIZE 1408 #define MAXVENDORINFO 32 #ifndef _SNMP_ASN_DEFINED #define _SNMP_ASN_DEFINED #define ASN_UNIVERSAL 0x00 #define ASN_PRIMITIVE 0x00 #define ASN_CONSTRUCTOR 0x20 #define ASN_APPLICATION 0x40 #define ASN_CONTEXT 0x80 #define ASN_PRIVATE 0xC0 #define SNMP_PDU_GET (ASN_CONTEXT | ASN_CONSTRUCTOR | 0) #define SNMP_PDU_GETNEXT (ASN_CONTEXT | ASN_CONSTRUCTOR | 1) #define SNMP_PDU_RESPONSE (ASN_CONTEXT | ASN_CONSTRUCTOR | 2) #define SNMP_PDU_SET (ASN_CONTEXT | ASN_CONSTRUCTOR | 3) #define SNMP_PDU_GETBULK (ASN_CONTEXT | ASN_CONSTRUCTOR | 4) #define SNMP_PDU_V1TRAP (ASN_CONTEXT | ASN_CONSTRUCTOR | 4) #define SNMP_PDU_INFORM (ASN_CONTEXT | ASN_CONSTRUCTOR | 6) #define SNMP_PDU_TRAP (ASN_CONTEXT | ASN_CONSTRUCTOR | 7) #define SNMP_PDU_REPORT (ASN_CONTEXT | ASN_CONSTRUCTOR | 8) #endif /* _SNMP_ASN_DEFINED */ #define SNMP_SYNTAX_SEQUENCE (ASN_UNIVERSAL | ASN_CONSTRUCTOR | 0x10) #define SNMP_SYNTAX_INT (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x02) #define SNMP_SYNTAX_BITS (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x03) #define SNMP_SYNTAX_OCTETS (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x04) #define SNMP_SYNTAX_NULL (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x05) #define SNMP_SYNTAX_OID (ASN_UNIVERSAL | ASN_PRIMITIVE | 0x06) #define SNMP_SYNTAX_IPADDR (ASN_APPLICATION | ASN_PRIMITIVE | 0x00) #define SNMP_SYNTAX_CNTR32 (ASN_APPLICATION | ASN_PRIMITIVE | 0x01) #define SNMP_SYNTAX_GAUGE32 (ASN_APPLICATION | ASN_PRIMITIVE | 0x02) #define SNMP_SYNTAX_TIMETICKS (ASN_APPLICATION | ASN_PRIMITIVE | 0x03) #define SNMP_SYNTAX_OPAQUE (ASN_APPLICATION | ASN_PRIMITIVE | 0x04) #define SNMP_SYNTAX_NSAPADDR (ASN_APPLICATION | ASN_PRIMITIVE | 0x05) #define SNMP_SYNTAX_CNTR64 (ASN_APPLICATION | ASN_PRIMITIVE | 0x06) #define SNMP_SYNTAX_UINT32 (ASN_APPLICATION | ASN_PRIMITIVE | 0x07) #define SNMP_SYNTAX_NOSUCHOBJECT (ASN_CONTEXT | ASN_PRIMITIVE | 0x00) #define SNMP_SYNTAX_NOSUCHINSTANCE (ASN_CONTEXT | ASN_PRIMITIVE | 0x01) #define SNMP_SYNTAX_ENDOFMIBVIEW (ASN_CONTEXT | ASN_PRIMITIVE | 0x02) #define SNMP_SYNTAX_INT32 SNMP_SYNTAX_INT #define SNMP_TRAP_COLDSTART 0 #define SNMP_TRAP_WARMSTART 1 #define SNMP_TRAP_LINKDOWN 2 #define SNMP_TRAP_LINKUP 3 #define SNMP_TRAP_AUTHFAIL 4 #define SNMP_TRAP_EGPNEIGHBORLOSS 5 #define SNMP_TRAP_ENTERPRISESPECIFIC 6 #define SNMP_ERROR_NOERROR 0 #define SNMP_ERROR_TOOBIG 1 #define SNMP_ERROR_NOSUCHNAME 2 #define SNMP_ERROR_BADVALUE 3 #define SNMP_ERROR_READONLY 4 #define SNMP_ERROR_GENERR 5 #define SNMP_ERROR_NOACCESS 6 #define SNMP_ERROR_WRONGTYPE 7 #define SNMP_ERROR_WRONGLENGTH 8 #define SNMP_ERROR_WRONGENCODING 9 #define SNMP_ERROR_WRONGVALUE 10 #define SNMP_ERROR_NOCREATION 11 #define SNMP_ERROR_INCONSISTENTVALUE 12 #define SNMP_ERROR_RESOURCEUNAVAILABLE 13 #define SNMP_ERROR_COMMITFAILED 14 #define SNMP_ERROR_UNDOFAILED 15 #define SNMP_ERROR_AUTHORIZATIONERROR 16 #define SNMP_ERROR_NOTWRITABLE 17 #define SNMP_ERROR_INCONSISTENTNAME 18 #define SNMP_SEC_MODEL_V1 1 #define SNMP_SEC_MODEL_V2 2 #define SNMP_SEC_MODEL_USM 3 #define SNMP_NOAUTH_NOPRIV 0 #define SNMP_AUTH_NOPRIV 1 #define SNMP_AUTH_PRIV 3 #define SNMP_USM_NO_AUTH_PROTOCOL 1 #define SNMP_USM_HMACMD5_AUTH_PROTOCOL 2 #define SNMP_USM_HMACSHA_AUTH_PROTOCOL 3 #define SNMP_USM_NO_PRIV_PROTOCOL 1 #define SNMP_USM_DES_PRIV_PROTOCOL 2 #define SNMPAPI_TRANSLATED 0 #define SNMPAPI_UNTRANSLATED_V1 1 #define SNMPAPI_UNTRANSLATED_V2 2 #define SNMPAPI_UNTRANSLATED_V3 3 #define SNMPAPI_OFF 0 #define SNMPAPI_ON 1 #define SNMPAPI_FAILURE 0 #define SNMPAPI_SUCCESS 1 #define SNMPAPI_NO_SUPPORT 0 #define SNMPAPI_V1_SUPPORT 1 #define SNMPAPI_V2_SUPPORT 2 #define SNMPAPI_M2M_SUPPORT 3 #define SNMPAPI_V3_SUPPORT 3 #define SNMPAPI_ALLOC_ERROR 2 #define SNMPAPI_CONTEXT_INVALID 3 #define SNMPAPI_CONTEXT_UNKNOWN 4 #define SNMPAPI_ENTITY_INVALID 5 #define SNMPAPI_ENTITY_UNKNOWN 6 #define SNMPAPI_INDEX_INVALID 7 #define SNMPAPI_NOOP 8 #define SNMPAPI_OID_INVALID 9 #define SNMPAPI_OPERATION_INVALID 10 #define SNMPAPI_OUTPUT_TRUNCATED 11 #define SNMPAPI_PDU_INVALID 12 #define SNMPAPI_SESSION_INVALID 13 #define SNMPAPI_SYNTAX_INVALID 14 #define SNMPAPI_VBL_INVALID 15 #define SNMPAPI_MODE_INVALID 16 #define SNMPAPI_SIZE_INVALID 17 #define SNMPAPI_NOT_INITIALIZED 18 #define SNMPAPI_MESSAGE_INVALID 19 #define SNMPAPI_HWND_INVALID 20 #define SNMPAPI_ENGINE_INVALID 30 #define SNMPAPI_ENGINE_DISCOVERY_FAILED 31 #define SNMPAPI_OTHER_ERROR 99 #define SNMPAPI_TL_NOT_INITIALIZED 100 #define SNMPAPI_TL_NOT_SUPPORTED 101 #define SNMPAPI_TL_NOT_AVAILABLE 102 #define SNMPAPI_TL_RESOURCE_ERROR 103 #define SNMPAPI_TL_UNDELIVERABLE 104 #define SNMPAPI_TL_SRC_INVALID 105 #define SNMPAPI_TL_INVALID_PARAM 106 #define SNMPAPI_TL_IN_USE 107 #define SNMPAPI_TL_TIMEOUT 108 #define SNMPAPI_TL_PDU_TOO_BIG 109 #define SNMPAPI_TL_OTHER 199 #define SNMPAPI_RPT_INVALIDMSG 200 #define SNMPAPI_RPT_INASNPARSEERR 201 #define SNMPAPI_RPT_UNKNOWNSECMODEL 202 #define SNMPAPI_RPT_UNKNOWNENGINEID 203 #define SNMPAPI_RPT_UNSUPPSECLEVEL 204 #define SNMPAPI_RPT_UNKNOWNUSERNAME 205 #define SNMPAPI_RPT_WRONGDIGEST 206 #define SNMPAPI_RPT_NOTINTIMEWINDOW 207 #define SNMPAPI_RPT_DECRYPTIONERROR 208 #define SNMPAPI_RPT_OTHER 299 #ifndef RC_INVOKED typedef HANDLE HSNMP_SESSION, *LPHSNMP_SESSION; typedef HANDLE HSNMP_CONTEXT, *LPHSNMP_CONTEXT; typedef HANDLE HSNMP_VBL, *LPHSNMP_VBL; typedef HANDLE HSNMP_PDU, *LPHSNMP_PDU; typedef HANDLE HSNMP_ENTITY, *LPHSNMP_ENTITY; typedef unsigned char smiBYTE, *smiLPBYTE; typedef signed int smiINT, *smiLPINT; typedef signed int smiINT32, *smiLPINT32; typedef unsigned int smiUINT32, *smiLPUINT32; typedef smiUINT32 smiCNTR32, *smiLPCNTR32; typedef smiUINT32 smiGAUGE32, *smiLPGAUGE32; typedef smiUINT32 smiTIMETICKS, *smiLPTIMETICKS; typedef smiUINT32 SNMPAPI_STATUS; typedef struct { smiUINT32 len; smiLPBYTE ptr; } smiOCTETS, *smiLPOCTETS, smiOPAQUE, *smiLPOPAQUE, smiBITS, *smiLPBITS, smiIPADDR, *smiLPIPADDR, smiNSAPADDR, *smiLPNSAPADDR; typedef const smiLPOCTETS smiLPCOCTETS; typedef struct { smiUINT32 len; smiLPUINT32 ptr; } smiOID, *smiLPOID; typedef const smiLPOID smiLPCOID; typedef struct { smiUINT32 hipart; smiUINT32 lopart; } smiCNTR64, *smiLPCNTR64; typedef struct { smiUINT32 syntax; union { smiINT sNumber; smiUINT32 uNumber; smiCNTR64 hNumber; smiOCTETS string; smiOID oid; smiBYTE empty; } value; } smiVALUE, *smiLPVALUE; typedef const smiLPVALUE smiLPCVALUE; typedef struct { CHAR vendorName[MAXVENDORINFO*2]; CHAR vendorContact[MAXVENDORINFO*2]; CHAR vendorVersionId[MAXVENDORINFO]; CHAR vendorVersionDate[MAXVENDORINFO]; smiUINT32 vendorEnterprise; } smiVENDORINFO, FAR *smiLPVENDORINFO; typedef SNMPAPI_STATUS (CALLBACK *SNMPAPI_CALLBACK)(HSNMP_SESSION,HWND,UINT,WPARAM,LPARAM,LPVOID); typedef struct { HSNMP_ENTITY hEntity; HSNMP_SESSION hSession; smiUINT32 nTranslateMode; smiUINT32 nSnmpVersion; smiOCTETS dFriendlyName; smiUINT32 nAddressFamily; smiOCTETS dAddressString; smiUINT32 nRequestPort; smiUINT32 nNotificationPort; smiUINT32 nMaxMsgSize; smiOCTETS dEngineID; smiUINT32 nEngineBoots; smiUINT32 nEngineTime; smiUINT32 nEngineSeconds; smiUINT32 nRetransmitMode; smiTIMETICKS nPolicyTimeout; smiUINT32 nPolicyRetry; smiTIMETICKS nActualTimeout; smiUINT32 nActualRetry; } smiENTITYINFO, *smiLPENTITYINFO; typedef struct { HSNMP_CONTEXT hContext; HSNMP_SESSION hSession; smiUINT32 nTranslateMode; smiUINT32 nSnmpVersion; smiOCTETS dFriendlyName; smiOCTETS dContextEngineID; smiOCTETS dContextName; smiOCTETS dSecurityName; smiUINT32 nSecurityModel; smiUINT32 nSecurityLevel; smiUINT32 nSecurityAuthProtocol; smiOCTETS dSecurityAuthKey; smiUINT32 nSecurityPrivProtocol; smiOCTETS dSecurityPrivKey; } smiCONTEXTINFO, *smiLPCONTEXTINFO; SNMPAPI_STATUS WINSNMPAPI SnmpCancelMsg(HSNMP_SESSION,smiINT32); SNMPAPI_STATUS WINSNMPAPI SnmpCleanup(VOID); SNMPAPI_STATUS WINSNMPAPI SnmpClose(HSNMP_SESSION); SNMPAPI_STATUS WINSNMPAPI SnmpContextToStr(HSNMP_CONTEXT,smiLPOCTETS); SNMPAPI_STATUS WINSNMPAPI SnmpCountVbl(HSNMP_VBL); HSNMP_PDU WINSNMPAPI SnmpCreatePdu(HSNMP_SESSION,smiINT,smiINT32,smiINT,smiINT,HSNMP_VBL); HSNMP_SESSION WINSNMPAPI SnmpCreateSession(HWND,UINT,SNMPAPI_CALLBACK,LPVOID); HSNMP_VBL WINSNMPAPI SnmpCreateVbl(HSNMP_SESSION,smiLPCOID,smiLPCVALUE); SNMPAPI_STATUS WINSNMPAPI SnmpDecodeMsg(HSNMP_SESSION,LPHSNMP_ENTITY,LPHSNMP_ENTITY,LPHSNMP_CONTEXT,LPHSNMP_PDU,smiLPCOCTETS); SNMPAPI_STATUS WINSNMPAPI SnmpDeleteVb(HSNMP_VBL,smiUINT32); HSNMP_PDU WINSNMPAPI SnmpDuplicatePdu(HSNMP_SESSION,HSNMP_PDU); HSNMP_VBL WINSNMPAPI SnmpDuplicateVbl(HSNMP_SESSION,HSNMP_VBL); SNMPAPI_STATUS WINSNMPAPI SnmpEncodeMsg(HSNMP_SESSION,HSNMP_ENTITY,HSNMP_ENTITY,HSNMP_CONTEXT,HSNMP_PDU,smiLPOCTETS); SNMPAPI_STATUS WINSNMPAPI SnmpEntityToStr(HSNMP_ENTITY,smiUINT32,LPSTR); SNMPAPI_STATUS WINSNMPAPI SnmpFreeContext(HSNMP_CONTEXT); SNMPAPI_STATUS WINSNMPAPI SnmpFreeDescriptor(smiUINT32,smiLPOPAQUE); SNMPAPI_STATUS WINSNMPAPI SnmpFreeEntity(HSNMP_ENTITY); SNMPAPI_STATUS WINSNMPAPI SnmpFreePdu(HSNMP_PDU); SNMPAPI_STATUS WINSNMPAPI SnmpFreeVbl(HSNMP_VBL); SNMPAPI_STATUS WINSNMPAPI SnmpGetLastError(HSNMP_SESSION); SNMPAPI_STATUS WINSNMPAPI SnmpGetPduData(HSNMP_PDU,smiLPINT,smiLPINT32,smiLPINT,smiLPINT,LPHSNMP_VBL); SNMPAPI_STATUS WINSNMPAPI SnmpGetRetransmitMode(smiLPUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpGetRetry(HSNMP_ENTITY,smiLPUINT32,smiLPUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpGetTimeout(HSNMP_ENTITY,smiLPTIMETICKS,smiLPTIMETICKS); SNMPAPI_STATUS WINSNMPAPI SnmpGetTranslateMode(smiLPUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpGetVb(HSNMP_VBL,smiUINT32,smiLPOID,smiLPVALUE); SNMPAPI_STATUS WINSNMPAPI SnmpGetVendorInfo(smiLPVENDORINFO); SNMPAPI_STATUS WINSNMPAPI SnmpListen(HSNMP_ENTITY,SNMPAPI_STATUS); SNMPAPI_STATUS WINSNMPAPI SnmpOidCompare(smiLPCOID,smiLPCOID,smiUINT32,smiLPINT); SNMPAPI_STATUS WINSNMPAPI SnmpOidCopy(smiLPCOID,smiLPOID); SNMPAPI_STATUS WINSNMPAPI SnmpOidToStr(smiLPCOID,smiUINT32,LPSTR); HSNMP_SESSION WINSNMPAPI SnmpOpen(HWND,UINT); SNMPAPI_STATUS WINSNMPAPI SnmpRecvMsg(HSNMP_SESSION,LPHSNMP_ENTITY,LPHSNMP_ENTITY,LPHSNMP_CONTEXT,LPHSNMP_PDU); SNMPAPI_STATUS WINSNMPAPI SnmpRegister(HSNMP_SESSION,HSNMP_ENTITY,HSNMP_ENTITY,HSNMP_CONTEXT,smiLPCOID,smiUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpSendMsg(HSNMP_SESSION,HSNMP_ENTITY,HSNMP_ENTITY,HSNMP_CONTEXT,HSNMP_PDU); SNMPAPI_STATUS WINSNMPAPI SnmpSetPduData(HSNMP_PDU,const smiINT *,const smiINT32 *,const smiINT *,const smiINT *,const HSNMP_VBL *); SNMPAPI_STATUS WINSNMPAPI SnmpSetPort(HSNMP_ENTITY,UINT); SNMPAPI_STATUS WINSNMPAPI SnmpSetRetransmitMode(smiUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpSetRetry(HSNMP_ENTITY,smiUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpSetTimeout(HSNMP_ENTITY,smiTIMETICKS); SNMPAPI_STATUS WINSNMPAPI SnmpSetTranslateMode(smiUINT32); SNMPAPI_STATUS WINSNMPAPI SnmpSetVb(HSNMP_VBL,smiUINT32,smiLPCOID,smiLPCVALUE); SNMPAPI_STATUS WINSNMPAPI SnmpStartup(smiLPUINT32,smiLPUINT32,smiLPUINT32,smiLPUINT32,smiLPUINT32); HSNMP_CONTEXT WINSNMPAPI SnmpStrToContext(HSNMP_SESSION,smiLPCOCTETS); HSNMP_ENTITY WINSNMPAPI SnmpStrToEntity(HSNMP_SESSION,LPCSTR); SNMPAPI_STATUS WINSNMPAPI SnmpStrToOid(LPCSTR,smiLPOID); /* Added in WinSNMP v3.0, not present in some (all?) versions of MS wsnmp32.dll */ HSNMP_ENTITY WINSNMPAPI SnmpCreateEntity(HSNMP_SESSION,smiLPENTITYINFO); SNMPAPI_STATUS WINSNMPAPI SnmpGetEntityInfo(HSNMP_ENTITY,smiLPENTITYINFO); SNMPAPI_STATUS WINSNMPAPI SnmpSetEntityInfo(HSNMP_ENTITY,smiLPENTITYINFO); SNMPAPI_STATUS WINSNMPAPI SnmpFreeEntityInfo(smiLPENTITYINFO); HSNMP_CONTEXT WINSNMPAPI SnmpCreateContext(HSNMP_SESSION,smiLPCONTEXTINFO); SNMPAPI_STATUS WINSNMPAPI SnmpGetContextInfo(HSNMP_CONTEXT,smiLPCONTEXTINFO); SNMPAPI_STATUS WINSNMPAPI SnmpSetContextInfo(HSNMP_CONTEXT,smiLPCONTEXTINFO); SNMPAPI_STATUS WINSNMPAPI SnmpFreeContextInfo(smiLPCONTEXTINFO); SNMPAPI_STATUS WINSNMPAPI SnmpPasswordToKey(smiLPOCTETS,smiINT32,smiLPOCTETS); #endif /* RC_INVOKED */ #ifdef __cplusplus } #endif #include #endif