| /* |
| winsnmp.h - Header file for the Windows SNMP API |
| |
| Written by Filip Navara <xnavara@volny.cz> |
| |
| 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 <windows.h> |
| #endif |
| |
| #include <pshpack4.h> |
| |
| #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 <poppack.h> |
| #endif |
