Changeset 253 for trunk/include/regfi.h

Timestamp:

06/12/11 22:27:42 (13 years ago)

Author:

tim

Message:

added preliminary interface to security descriptors in pyregfi
misc bug fixes

File:

• trunk/include/regfi.h (modified) (3 diffs)

trunk/include/regfi.h

@@ -74 +74 @@
 
 /* regfi headers */
-#include <byteorder.h>
-#include <winsec.h>
-#include <void_stack.h>
-#include <range_list.h>
-#include <lru_cache.h>
-
-/* GCC-specific macro for library exports */
-#ifdef _EXPORT
-#undef _EXPORT
-#endif
-#ifdef REGFI_WIN32
-#define _EXPORT() __declspec(dllexport)
-#else
-#define _EXPORT() __attribute__((visibility("default")))
-#endif
-
-#ifndef EOVERFLOW
-# define EOVERFLOW E2BIG
-#endif
+#include "compat.h"
+#include "byteorder.h"
+#include "winsec.h"
+#include "void_stack.h"
+#include "range_list.h"
+#include "lru_cache.h"
 
 /******************************************************************************/
@@ -1094 +1081 @@
 
 
+/** Returns the next SK (security) record referenced by the supplied SK record
+ *
+ * @param file the file from which sk is derived
+ * @param sk   the SK record whose next sibling SK record is desired
+ * 
+ * @return A read-only SK structure, or NULL on failure.
+ *
+ * @note
+ * SK records are included in a circular, doubly-linked list.
+ * To iterate over all SK records, be sure to check for the repetition of
+ * the SK record you started with to determine when all have been traversed.
+ *
+ * @ingroup regfiBase
+ */
+_EXPORT()
+const REGFI_SK* regfi_next_sk(REGFI_FILE* file, const REGFI_SK* sk);
+
+
+/** Returns the previous SK (security) record referenced by the supplied SK record
+ *
+ * @param file the file from which sk is derived
+ * @param sk   the SK record whose previous sibling SK record is desired
+ * 
+ * @return A read-only SK structure, or NULL on failure.
+ *
+ * @note
+ * SK records are included in a circular, doubly-linked list.
+ * To iterate over all SK records, be sure to check for the repetition of
+ * the SK record you started with to determine when all have been traversed.
+ *
+ * @ingroup regfiBase
+ */
+_EXPORT()
+const REGFI_SK* regfi_prev_sk(REGFI_FILE* file, const REGFI_SK* sk);
+
+
 /** Retrieves data for a given value.
  *
@@ -1542 +1565 @@
 _EXPORT()
 const REGFI_SK* regfi_load_sk(REGFI_FILE* file, uint32_t offset,
-                                  bool strict);
+                              bool strict);