You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

108 lines
4.2 KiB

  1. /* /////////////////////////////////////////////////////////////////////////
  2. * File: pantheios/backends/bec.WindowsMessageBox.h
  3. *
  4. * Purpose: Declaration of the Pantheios WindowsMessageBox Stock Back-end API.
  5. *
  6. * Created: 8th March 2008
  7. * Updated: 11th September 2009
  8. *
  9. * Home: http://www.pantheios.org/
  10. *
  11. * Copyright (c) 2008-2009, Matthew Wilson and Synesis Software
  12. * All rights reserved.
  13. *
  14. * Redistribution and use in source and binary forms, with or without
  15. * modification, are permitted provided that the following conditions are
  16. * met:
  17. *
  18. * - Redistributions of source code must retain the above copyright notice,
  19. * this list of conditions and the following disclaimer.
  20. * - Redistributions in binary form must reproduce the above copyright
  21. * notice, this list of conditions and the following disclaimer in the
  22. * documentation and/or other materials provided with the distribution.
  23. * - Neither the name(s) of Matthew Wilson and Synesis Software nor the
  24. * names of any contributors may be used to endorse or promote products
  25. * derived from this software without specific prior written permission.
  26. *
  27. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
  28. * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  29. * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  30. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  31. * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  32. * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  33. * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  34. * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  35. * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  36. * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  37. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38. *
  39. * ////////////////////////////////////////////////////////////////////// */
  40. /** \file pantheios/backends/bec.WindowsMessageBox.h
  41. *
  42. * [C, C++] Pantheios Windows Message Box Back-end Common API
  43. */
  44. #ifndef PANTHEIOS_INCL_PANTHEIOS_BACKENDS_H_WINDOWSMESSAGEBOX
  45. #define PANTHEIOS_INCL_PANTHEIOS_BACKENDS_H_WINDOWSMESSAGEBOX
  46. /* /////////////////////////////////////////////////////////////////////////
  47. * Includes
  48. */
  49. #ifndef PANTHEIOS_INCL_PANTHEIOS_H_PANTHEIOS
  50. # include <pantheios/pantheios.h>
  51. #endif /* !PANTHEIOS_INCL_PANTHEIOS_H_PANTHEIOS */
  52. #ifndef PANTHEIOS_INCL_PANTHEIOS_H_BACKEND
  53. # include <pantheios/backend.h>
  54. #endif /* !PANTHEIOS_INCL_PANTHEIOS_H_BACKEND */
  55. /* /////////////////////////////////////////////////////////////////////////
  56. * Documentation
  57. */
  58. /** \defgroup group__backend__stock_backends__WindowsMessageBox Pantheios Windows Message Box Stock Back-end
  59. * \ingroup group__backend__stock_backends
  60. * Back-end library that writes to the Windows event log.
  61. */
  62. /* /////////////////////////////////////////////////////////////////////////
  63. * API
  64. */
  65. /** Implements the functionality for pantheios_be_init() over the Windows Message Box API.
  66. *
  67. * \ingroup group__backend__stock_backends__WindowsMessageBox
  68. */
  69. PANTHEIOS_CALL(int) pantheios_be_WindowsMessageBox_init(
  70. PAN_CHAR_T const* processIdentity
  71. , int id
  72. , void* unused
  73. , void* reserved
  74. , void** ptoken
  75. );
  76. /** Implements the functionality for pantheios_be_uninit() over the Windows Message Box API.
  77. * \ingroup group__backend__stock_backends__WindowsMessageBox
  78. */
  79. PANTHEIOS_CALL(void) pantheios_be_WindowsMessageBox_uninit(
  80. void* token
  81. );
  82. /** Implements the functionality for pantheios_be_logEntry() over the Windows Message Box API.
  83. * \ingroup group__backend__stock_backends__WindowsMessageBox
  84. */
  85. PANTHEIOS_CALL(int) pantheios_be_WindowsMessageBox_logEntry(
  86. void* feToken
  87. , void* beToken
  88. , int severity
  89. , PAN_CHAR_T const* entry
  90. , size_t cchEntry
  91. );
  92. /* ////////////////////////////////////////////////////////////////////// */
  93. #endif /* PANTHEIOS_INCL_PANTHEIOS_BACKENDS_H_WINDOWSMESSAGEBOX */
  94. /* ///////////////////////////// end of file //////////////////////////// */