Stub and documentation for RtlFormatMessage.

dlls/ntdll/ntdll.spec

@@ -423,7 +423,7 @@
 @ stub RtlFirstEntrySList
 @ stdcall RtlFirstFreeAce(ptr ptr)
 @ stdcall RtlFormatCurrentUserKeyPath(ptr)
-@ stub RtlFormatMessage
+@ stdcall RtlFormatMessage(ptr long long long long ptr ptr long)
 @ stdcall RtlFreeAnsiString(long)
 @ stub RtlFreeHandle
 @ stdcall RtlFreeHeap(long long long)

dlls/ntdll/resource.c

@@ -399,6 +399,34 @@ NTSTATUS WINAPI RtlFindMessage( HMODULE hmod, ULONG type, ULONG lang,
     return STATUS_MESSAGE_NOT_FOUND;
 }
 
+/**********************************************************************
+ *	RtlFormatMessage  (NTDLL.@)
+ *
+ * Formats a message (similar to sprintf).
+ *
+ * PARAMS
+ *   Message          [I] Message to format.
+ *   MaxWidth         [I] Maximum width in characters of each output line.
+ *   IgnoreInserts    [I] Whether to copy the message without processing inserts.
+ *   Ansi             [I] Whether Arguments may have ANSI strings.
+ *   ArgumentsIsArray [I] Whether Arguments is actually an array rather than a va_list *.
+ *   Buffer           [O] Buffer to store processed message in.
+ *   BufferSize       [I] Size of Buffer (in bytes?).
+ *
+ * RETURNS
+ *      NTSTATUS code.
+ */
+NTSTATUS WINAPI RtlFormatMessage( LPWSTR Message, UCHAR MaxWidth,
+                                  BOOLEAN IgnoreInserts, BOOLEAN Ansi,
+                                  BOOLEAN ArgumentIsArray, va_list * Arguments,
+                                  LPWSTR Buffer, ULONG BufferSize )
+{
+    FIXME("(%s, %u, %s, %s, %s, %p, %p, %ld)\n", debugstr_w(Message),
+        MaxWidth, IgnoreInserts ? "TRUE" : "FALSE", Ansi ? "TRUE" : "FALSE",
+        ArgumentIsArray ? "TRUE" : "FALSE", Arguments, Buffer, BufferSize);
+    return STATUS_SUCCESS;
+}
+
 
 /**********************************************************************
  *	NtQueryDefaultLocale  (NTDLL.@)

include/winternl.h

@@ -1322,6 +1322,7 @@ ULONG     WINAPI RtlFindSetBitsAndClear(PRTL_BITMAP,ULONG,ULONG);
 ULONG     WINAPI RtlFindSetRuns(PCRTL_BITMAP,PRTL_BITMAP_RUN,ULONG,BOOLEAN);
 BOOLEAN   WINAPI RtlFirstFreeAce(PACL,PACE_HEADER *);
 NTSTATUS  WINAPI RtlFormatCurrentUserKeyPath(PUNICODE_STRING);
+NTSTATUS  WINAPI RtlFormatMessage(LPWSTR,UCHAR,BOOLEAN,BOOLEAN,BOOLEAN,va_list *,LPWSTR,ULONG);
 void      WINAPI RtlFreeAnsiString(PANSI_STRING);
 BOOLEAN   WINAPI RtlFreeHeap(HANDLE,ULONG,PVOID);
 void      WINAPI RtlFreeOemString(POEM_STRING);