[KERNEL32]: Clarify the difference between the macro and Basep8BitStringToStaticUnicodeString.

svn path=/trunk/; revision=52779
This commit is contained in:
Alex Ionescu 2011-07-22 10:10:15 +00:00
parent 278fb2f2b6
commit 2374f5b1aa

View file

@ -22,6 +22,14 @@
// It returns the correct ERROR_FILENAME_EXCED_RANGE Win32 error when the path // It returns the correct ERROR_FILENAME_EXCED_RANGE Win32 error when the path
// is too long. // is too long.
// //
// Note that Basep8BitStringToStaticUnicodeString looks deceptively similar.
// However, that function was designed for File APIs, which can be switched into
// a special "OEM" mode, that uses different NLS files/encoding, and thus calls
// RtlOemStringToAnsiString (see SetFileApisToOEM). Thererefore, this macro and
// that function are not interchangeable. As a separate note, that function uses
// the *Ex version of the Rtl conversion APIs, which does stricter checking that
// is not done when this macro is used.
//
#define ConvertAnsiToUnicodePrologue \ #define ConvertAnsiToUnicodePrologue \
{ \ { \
NTSTATUS Status; \ NTSTATUS Status; \