reactos/include/snmp.h

   1 /*
   2   snmp.h - Header file for the Windows SNMP API
   3
   4   Written by Filip Navara <xnavara@volny.cz>
   5
   6   References (2003-08-25):
   7     http://msdn.microsoft.com/library/en-us/snmp/snmp/snmp_reference.asp
   8
   9   This library is distributed in the hope that it will be useful,
  10   but WITHOUT ANY WARRANTY; without even the implied warranty of
  11   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  12 */
  13
  14 #ifndef _SNMP_H
  15 #define _SNMP_H
  16 #if __GNUC__ >= 3
  17 #pragma GCC system_header
  18 #endif
  19
  20 #ifndef _WINDOWS_H
  21 #include <windows.h>
  22 #endif
  23
  24 #include <pshpack4.h>
  25
  26 #ifndef WINSNMPAPI
  27 #define WINSNMPAPI WINAPI
  28 #endif
  29
  30 #ifdef __cplusplus
  31 extern "C" {
  32 #endif
  33
  34 #define DEFAULT_SNMP_PORT_UDP   161
  35 #define DEFAULT_SNMP_PORT_IPX   36879
  36 #define DEFAULT_SNMPTRAP_PORT_UDP       162
  37 #define DEFAULT_SNMPTRAP_PORT_IPX       36880
  38 #ifndef _SNMP_ASN_DEFINED
  39 #define _SNMP_ASN_DEFINED
  40 #define ASN_UNIVERSAL   0x00
  41 #define ASN_PRIMITIVE   0x00
  42 #define ASN_CONSTRUCTOR 0x20
  43 #define ASN_APPLICATION 0x40
  44 #define ASN_CONTEXT     0x80
  45 #define ASN_PRIVATE     0xC0
  46 #define SNMP_PDU_GET    (ASN_CONTEXT | ASN_CONSTRUCTOR | 0)
  47 #define SNMP_PDU_GETNEXT        (ASN_CONTEXT | ASN_CONSTRUCTOR | 1)
  48 #define SNMP_PDU_RESPONSE       (ASN_CONTEXT | ASN_CONSTRUCTOR | 2)
  49 #define SNMP_PDU_SET    (ASN_CONTEXT | ASN_CONSTRUCTOR | 3)
  50 #define SNMP_PDU_GETBULK        (ASN_CONTEXT | ASN_CONSTRUCTOR | 4)
  51 #define SNMP_PDU_V1TRAP (ASN_CONTEXT | ASN_CONSTRUCTOR | 4)
  52 #define SNMP_PDU_INFORM (ASN_CONTEXT | ASN_CONSTRUCTOR | 6)
  53 #define SNMP_PDU_TRAP   (ASN_CONTEXT | ASN_CONSTRUCTOR | 7)
  54 #define SNMP_PDU_REPORT (ASN_CONTEXT | ASN_CONSTRUCTOR | 8)
  55 #endif /* _SNMP_ASN_DEFINED */
  56 #define ASN_INTEGER     (ASN_UNIVERSAL | ASN_PRIMITIVE | 2)
  57 #define ASN_BITS        (ASN_UNIVERSAL | ASN_PRIMITIVE | 3)
  58 #define ASN_OCTETSTRING (ASN_UNIVERSAL | ASN_PRIMITIVE | 4)
  59 #define ASN_NULL        (ASN_UNIVERSAL | ASN_PRIMITIVE | 5)
  60 #define ASN_OBJECTIDENTIFIER    (ASN_UNIVERSAL | ASN_PRIMITIVE | 6)
  61 #define ASN_INTEGER32   ASN_INTEGER
  62 #define ASN_SEQUENCE    (ASN_UNIVERSAL | ASN_CONSTRUCTOR | 0x10)
  63 #define ASN_SEQUENCEOF  ASN_SEQUENCE
  64 #define ASN_IPADDRESS   (ASN_APPLICATION | ASN_PRIMITIVE | 0x00)
  65 #define ASN_COUNTER32   (ASN_APPLICATION | ASN_PRIMITIVE | 0x01)
  66 #define ASN_GAUGE32     (ASN_APPLICATION | ASN_PRIMITIVE | 0x02)
  67 #define ASN_TIMETICKS   (ASN_APPLICATION | ASN_PRIMITIVE | 0x03)
  68 #define ASN_OPAQUE      (ASN_APPLICATION | ASN_PRIMITIVE | 0x04)
  69 #define ASN_COUNTER64   (ASN_APPLICATION | ASN_PRIMITIVE | 0x06)
  70 #define ASN_UNSIGNED32  (ASN_APPLICATION | ASN_PRIMITIVE | 0x07)
  71 #define SNMP_EXCEPTION_NOSUCHOBJECT     (ASN_CONTEXT | ASN_PRIMITIVE | 0x00)
  72 #define SNMP_EXCEPTION_NOSUCHINSTANCE   (ASN_CONTEXT | ASN_PRIMITIVE | 0x01)
  73 #define SNMP_EXCEPTION_ENDOFMIBVIEW     (ASN_CONTEXT | ASN_PRIMITIVE | 0x02)
  74 #define SNMP_EXTENSION_GET      SNMP_PDU_GET
  75 #define SNMP_EXTENSION_GET_NEXT SNMP_PDU_GETNEXT
  76 #define SNMP_EXTENSION_GET_BULK SNMP_PDU_GETBULK
  77 #define SNMP_EXTENSION_SET_TEST (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x0)
  78 #define SNMP_EXTENSION_SET_COMMIT       SNMP_PDU_SET
  79 #define SNMP_EXTENSION_SET_UNDO (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x1)
  80 #define SNMP_EXTENSION_SET_CLEANUP      (ASN_PRIVATE | ASN_CONSTRUCTOR | 0x2)
  81 #define SNMP_ERRORSTATUS_NOERROR        0
  82 #define SNMP_ERRORSTATUS_TOOBIG 1
  83 #define SNMP_ERRORSTATUS_NOSUCHNAME     2
  84 #define SNMP_ERRORSTATUS_BADVALUE       3
  85 #define SNMP_ERRORSTATUS_READONLY       4
  86 #define SNMP_ERRORSTATUS_GENERR 5
  87 #define SNMP_ERRORSTATUS_NOACCESS       6
  88 #define SNMP_ERRORSTATUS_WRONGTYPE      7
  89 #define SNMP_ERRORSTATUS_WRONGLENGTH    8
  90 #define SNMP_ERRORSTATUS_WRONGENCODING  9
  91 #define SNMP_ERRORSTATUS_WRONGVALUE     10
  92 #define SNMP_ERRORSTATUS_NOCREATION     11
  93 #define SNMP_ERRORSTATUS_INCONSISTENTVALUE      12
  94 #define SNMP_ERRORSTATUS_RESOURCEUNAVAILABLE    13
  95 #define SNMP_ERRORSTATUS_COMMITFAILED   14
  96 #define SNMP_ERRORSTATUS_UNDOFAILED     15
  97 #define SNMP_ERRORSTATUS_AUTHORIZATIONERROR     16
  98 #define SNMP_ERRORSTATUS_NOTWRITABLE    17
  99 #define SNMP_ERRORSTATUS_INCONSISTENTNAME       18
 100 #define SNMP_GENERICTRAP_COLDSTART      0
 101 #define SNMP_GENERICTRAP_WARMSTART      1
 102 #define SNMP_GENERICTRAP_LINKDOWN       2
 103 #define SNMP_GENERICTRAP_LINKUP 3
 104 #define SNMP_GENERICTRAP_AUTHFAILURE    4
 105 #define SNMP_GENERICTRAP_EGPNEIGHLOSS   5
 106 #define SNMP_GENERICTRAP_ENTERSPECIFIC  6
 107 #define SNMP_ACCESS_NONE        0
 108 #define SNMP_ACCESS_NOTIFY      1
 109 #define SNMP_ACCESS_READ_ONLY   2
 110 #define SNMP_ACCESS_READ_WRITE  3
 111 #define SNMP_ACCESS_READ_CREATE 4
 112 #define SNMPAPI_ERROR   FALSE
 113 #define SNMPAPI_NOERROR TRUE
 114 #define SNMP_LOG_SILENT 0
 115 #define SNMP_LOG_FATAL  1
 116 #define SNMP_LOG_ERROR  2
 117 #define SNMP_LOG_WARNING        3
 118 #define SNMP_LOG_TRACE  4
 119 #define SNMP_LOG_VERBOSE        5
 120 #define SNMP_OUTPUT_TO_CONSOLE  1
 121 #define SNMP_OUTPUT_TO_LOGFILE  2
 122 #define SNMP_OUTPUT_TO_EVENTLOG 4
 123 #define SNMP_OUTPUT_TO_DEBUGGER 8
 124 #define SNMP_MAX_OID_LEN        128
 125 #define SNMP_MEM_ALLOC_ERROR    1
 126 #define SNMP_BERAPI_INVALID_LENGTH      10
 127 #define SNMP_BERAPI_INVALID_TAG 11
 128 #define SNMP_BERAPI_OVERFLOW    12
 129 #define SNMP_BERAPI_SHORT_BUFFER        13
 130 #define SNMP_BERAPI_INVALID_OBJELEM     14
 131 #define SNMP_PDUAPI_UNRECOGNIZED_PDU    20
 132 #define SNMP_PDUAPI_INVALID_ES  21
 133 #define SNMP_PDUAPI_INVALID_GT  22
 134 #define SNMP_AUTHAPI_INVALID_VERSION    30
 135 #define SNMP_AUTHAPI_INVALID_MSG_TYPE   31
 136 #define SNMP_AUTHAPI_TRIV_AUTH_FAILED   32
 137
 138 #ifndef RC_INVOKED
 139
 140 typedef INT SNMPAPI;
 141 typedef LONG AsnInteger32;
 142 typedef ULONG AsnUnsigned32;
 143 typedef ULARGE_INTEGER AsnCounter64;
 144 typedef AsnUnsigned32 AsnCounter32;
 145 typedef AsnUnsigned32 AsnGauge32;
 146 typedef AsnUnsigned32 AsnTimeticks;
 147 typedef struct {
 148         BYTE *stream;
 149         UINT length;
 150         BOOL dynamic;
 151 } AsnOctetString, AsnBits, AsnSequence, AsnImplicitSequence, AsnIPAddress, AsnNetworkAddress, AsnDisplayString, AsnOpaque;
 152 typedef struct {
 153         UINT idLength;
 154         UINT *ids;
 155 } AsnObjectIdentifier, AsnObjectName;
 156 typedef struct {
 157         BYTE asnType;
 158         union {
 159                 AsnInteger32 number;
 160                 AsnUnsigned32 unsigned32;
 161                 AsnCounter64 counter64;
 162                 AsnOctetString string;
 163                 AsnBits bits;
 164                 AsnObjectIdentifier object;
 165                 AsnSequence sequence;
 166                 AsnIPAddress address;
 167                 AsnCounter32 counter;
 168                 AsnGauge32 gauge;
 169                 AsnTimeticks ticks;
 170                 AsnOpaque arbitrary;
 171         } asnValue;
 172 } AsnAny, AsnObjectSyntax;
 173 typedef struct {
 174         AsnObjectName name;
 175         AsnObjectSyntax value;
 176 } SnmpVarBind;
 177 typedef struct {
 178         SnmpVarBind *list;
 179         UINT len;
 180 } SnmpVarBindList;
 181
 182 VOID WINSNMPAPI SnmpExtensionClose(void);
 183 BOOL WINSNMPAPI SnmpExtensionInit(DWORD,HANDLE*,AsnObjectIdentifier*);
 184 BOOL WINSNMPAPI SnmpExtensionInitEx(AsnObjectIdentifier*);
 185 BOOL WINSNMPAPI SnmpExtensionMonitor(LPVOID);
 186 BOOL WINSNMPAPI SnmpExtensionQuery(BYTE,SnmpVarBindList*,AsnInteger32*,AsnInteger32*);
 187 BOOL WINSNMPAPI SnmpExtensionQueryEx(DWORD,DWORD,SnmpVarBindList*,AsnOctetString*,AsnInteger32*,AsnInteger32*);
 188 BOOL WINSNMPAPI SnmpExtensionTrap(AsnObjectIdentifier*,AsnInteger32*,AsnInteger32*,AsnTimeticks*,SnmpVarBindList*);
 189 DWORD WINSNMPAPI SnmpSvcGetUptime(void);
 190 VOID WINSNMPAPI SnmpSvcSetLogLevel(INT);
 191 VOID WINSNMPAPI SnmpSvcSetLogType(INT);
 192 SNMPAPI WINSNMPAPI SnmpUtilAsnAnyCpy(AsnAny*,AsnAny*);
 193 VOID WINSNMPAPI SnmpUtilAsnAnyFree(AsnAny*);
 194 VOID WINSNMPAPI SnmpUtilDbgPrint(INT,LPSTR,...);
 195 LPSTR WINSNMPAPI SnmpUtilIdsToA(UINT*,UINT);
 196 LPVOID WINSNMPAPI SnmpUtilMemAlloc(UINT);
 197 VOID WINSNMPAPI SnmpUtilMemFree(LPVOID);
 198 LPVOID WINSNMPAPI SnmpUtilMemReAlloc(LPVOID,UINT);
 199 SNMPAPI WINSNMPAPI SnmpUtilOctetsCmp(AsnOctetString*,AsnOctetString*);
 200 SNMPAPI WINSNMPAPI SnmpUtilOctetsCpy(AsnOctetString*,AsnOctetString*);
 201 VOID WINSNMPAPI SnmpUtilOctetsFree(AsnOctetString*);
 202 SNMPAPI WINSNMPAPI SnmpUtilOctetsNCmp(AsnOctetString*,AsnOctetString*,UINT);
 203 SNMPAPI WINSNMPAPI SnmpUtilOidAppend(AsnObjectIdentifier*,AsnObjectIdentifier*);
 204 SNMPAPI WINSNMPAPI SnmpUtilOidCmp(AsnObjectIdentifier*,AsnObjectIdentifier*);
 205 SNMPAPI WINSNMPAPI SnmpUtilOidCpy(AsnObjectIdentifier*,AsnObjectIdentifier*);
 206 VOID WINSNMPAPI SnmpUtilOidFree(AsnObjectIdentifier*);
 207 SNMPAPI WINSNMPAPI SnmpUtilOidNCmp(AsnObjectIdentifier*,AsnObjectIdentifier*,UINT);
 208 LPSTR WINSNMPAPI SnmpUtilOidToA(AsnObjectIdentifier*);
 209 VOID WINSNMPAPI SnmpUtilPrintAsnAny(AsnAny*);
 210 VOID WINSNMPAPI SnmpUtilPrintOid(AsnObjectIdentifier*);
 211 SNMPAPI WINSNMPAPI SnmpUtilVarBindCpy(  SnmpVarBind*,SnmpVarBind*);
 212 SNMPAPI WINSNMPAPI SnmpUtilVarBindListCpy(SnmpVarBindList*,SnmpVarBindList*);
 213 VOID WINSNMPAPI SnmpUtilVarBindFree(SnmpVarBind*);
 214 VOID WINSNMPAPI SnmpUtilVarBindListFree(SnmpVarBindList*);
 215
 216 #ifndef SNMPSTRICT
 217 #define SNMP_malloc SnmpUtilMemAlloc
 218 #define SNMP_free SnmpUtilMemFree
 219 #define SNMP_realloc SnmpUtilMemReAlloc
 220 #define SNMP_DBG_malloc SnmpUtilMemAlloc
 221 #define SNMP_DBG_free SnmpUtilMemFree
 222 #define SNMP_DBG_realloc SnmpUtilMemReAlloc
 223 #define SNMP_oidappend SnmpUtilOidAppend
 224 #define SNMP_oidcmp SnmpUtilOidCmp
 225 #define SNMP_oidcpy SnmpUtilOidCpy
 226 #define SNMP_oidfree SnmpUtilOidFree
 227 #define SNMP_oidncmp SnmpUtilOidNCmp
 228 #define SNMP_printany SnmpUtilPrintAsnAny
 229 #define SNMP_CopyVarBind SnmpUtilVarBindCpy
 230 #define SNMP_CopyVarBindList SnmpUtilVarBindListCpy
 231 #define SNMP_FreeVarBind SnmpUtilVarBindFree
 232 #define SNMP_FreeVarBindList SnmpUtilVarBindListFree
 233 #define ASN_RFC1155_IPADDRESS ASN_IPADDRESS
 234 #define ASN_RFC1155_COUNTER ASN_COUNTER32
 235 #define ASN_RFC1155_GAUGE ASN_GAUGE32
 236 #define ASN_RFC1155_TIMETICKS ASN_TIMETICKS
 237 #define ASN_RFC1155_OPAQUE ASN_OPAQUE
 238 #define ASN_RFC1213_DISPSTRING ASN_OCTETSTRING
 239 #define ASN_RFC1157_GETREQUEST SNMP_PDU_GET
 240 #define ASN_RFC1157_GETNEXTREQUEST SNMP_PDU_GETNEXT
 241 #define ASN_RFC1157_GETRESPONSE SNMP_PDU_RESPONSE
 242 #define ASN_RFC1157_SETREQUEST SNMP_PDU_SET
 243 #define ASN_RFC1157_TRAP SNMP_PDU_V1TRAP
 244 #define ASN_CONTEXTSPECIFIC ASN_CONTEXT
 245 #define ASN_PRIMATIVE ASN_PRIMITIVE
 246 #define RFC1157VarBindList SnmpVarBindList
 247 #define RFC1157VarBind SnmpVarBind
 248 #define AsnInteger AsnInteger32
 249 #define AsnCounter AsnCounter32
 250 #define AsnGauge AsnGauge32
 251 #endif /* SNMPSTRICT */
 252
 253 #endif /* RC_INVOKED */
 254
 255 #ifdef __cplusplus
 256 }
 257 #endif
 258 #include <poppack.h>
 259 #endif