Add function to translate status value to string

2 files changed, 30 insertions, 0 deletions

diff --git a/include/MinHook.h b/include/MinHook.h
index 31b9d06..aa6763b 100644
--- a/include/MinHook.h
+++ b/include/MinHook.h
@@ -160,6 +160,9 @@ extern "C" {
     // Applies all queued changes in one go.
     MH_STATUS WINAPI MH_ApplyQueued(VOID);
 
+    // Translates the MH_STATUS to its name as a string.
+    const char * WINAPI MH_StatusToString(MH_STATUS status);
+
 #ifdef __cplusplus
 }
 #endif
diff --git a/src/hook.c b/src/hook.c
index ae2d01d..d2bbfd0 100644
--- a/src/hook.c
+++ b/src/hook.c
@@ -843,3 +843,30 @@ MH_STATUS WINAPI MH_CreateHookApi(
 
     return MH_CreateHook(pTarget, pDetour, ppOriginal);
 }
+
+//-------------------------------------------------------------------------
+const char * WINAPI MH_StatusToString(MH_STATUS status)
+{
+    #define MH_ST2STR(x) \
+    case x: \
+        return #x;
+
+    switch (status) {
+        MH_ST2STR(MH_UNKNOWN)
+        MH_ST2STR(MH_OK)
+        MH_ST2STR(MH_ERROR_ALREADY_INITIALIZED)
+        MH_ST2STR(MH_ERROR_NOT_INITIALIZED)
+        MH_ST2STR(MH_ERROR_ALREADY_CREATED)
+        MH_ST2STR(MH_ERROR_NOT_CREATED)
+        MH_ST2STR(MH_ERROR_ENABLED)
+        MH_ST2STR(MH_ERROR_DISABLED)
+        MH_ST2STR(MH_ERROR_NOT_EXECUTABLE)
+        MH_ST2STR(MH_ERROR_UNSUPPORTED_FUNCTION)
+        MH_ST2STR(MH_ERROR_MEMORY_ALLOC)
+        MH_ST2STR(MH_ERROR_MEMORY_PROTECT)
+    }
+
+#undef MH_ST2STR
+
+    return "(unknown)";
+}