]> wimlib.net Git - wimlib/blobdiff - src/win32_common.c
Capitalize "Windows Overlay Filesystem" consistently
[wimlib] / src / win32_common.c
index e3dace38946f8f912b4ded844662c49bc8bef4ad..514965b869091c8741519cedaad8f412afba0942 100644 (file)
@@ -3,22 +3,20 @@
  */
 
 /*
- * Copyright (C) 2013 Eric Biggers
+ * Copyright (C) 2013-2016 Eric Biggers
  *
- * This file is part of wimlib, a library for working with WIM files.
+ * This file is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License as published by the Free
+ * Software Foundation; either version 3 of the License, or (at your option) any
+ * later version.
  *
- * wimlib is free software; you can redistribute it and/or modify it under the
- * terms of the GNU General Public License as published by the Free
- * Software Foundation; either version 3 of the License, or (at your option)
- * any later version.
- *
- * wimlib is distributed in the hope that it will be useful, but WITHOUT ANY
- * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
- * A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * This file is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
  * details.
  *
- * You should have received a copy of the GNU General Public License
- * along with wimlib; if not, see http://www.gnu.org/licenses/.
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this file; if not, see http://www.gnu.org/licenses/.
  */
 
 #ifdef __WIN32__
 #  include "config.h"
 #endif
 
-#include <errno.h>
-
 #include "wimlib/win32_common.h"
 
 #include "wimlib/assert.h"
 #include "wimlib/error.h"
 #include "wimlib/util.h"
-
-#ifdef ENABLE_ERROR_MESSAGES
-void
-win32_error(DWORD err_code)
-{
-       wchar_t *buffer;
-       DWORD nchars;
-       nchars = FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM |
-                                   FORMAT_MESSAGE_ALLOCATE_BUFFER,
-                               NULL, err_code, 0,
-                               (wchar_t*)&buffer, 0, NULL);
-       if (nchars == 0) {
-               ERROR("Error printing error message! "
-                     "Computer will self-destruct in 3 seconds.");
-       } else {
-               ERROR("Win32 error: %ls", buffer);
-               LocalFree(buffer);
-       }
-}
-#endif /* ENABLE_ERROR_MESSAGES */
-
-int
-win32_error_to_errno(DWORD err_code)
-{
-       /* This mapping is that used in Cygwin.
-        * Some of these choices are arbitrary. */
-       switch (err_code) {
-       case ERROR_ACCESS_DENIED:
-               return EACCES;
-       case ERROR_ACTIVE_CONNECTIONS:
-               return EAGAIN;
-       case ERROR_ALREADY_EXISTS:
-               return EEXIST;
-       case ERROR_BAD_DEVICE:
-               return ENODEV;
-       case ERROR_BAD_EXE_FORMAT:
-               return ENOEXEC;
-       case ERROR_BAD_NETPATH:
-               return ENOENT;
-       case ERROR_BAD_NET_NAME:
-               return ENOENT;
-       case ERROR_BAD_NET_RESP:
-               return ENOSYS;
-       case ERROR_BAD_PATHNAME:
-               return ENOENT;
-       case ERROR_BAD_PIPE:
-               return EINVAL;
-       case ERROR_BAD_UNIT:
-               return ENODEV;
-       case ERROR_BAD_USERNAME:
-               return EINVAL;
-       case ERROR_BEGINNING_OF_MEDIA:
-               return EIO;
-       case ERROR_BROKEN_PIPE:
-               return EPIPE;
-       case ERROR_BUSY:
-               return EBUSY;
-       case ERROR_BUS_RESET:
-               return EIO;
-       case ERROR_CALL_NOT_IMPLEMENTED:
-               return ENOSYS;
-       case ERROR_CANNOT_MAKE:
-               return EPERM;
-       case ERROR_CHILD_NOT_COMPLETE:
-               return EBUSY;
-       case ERROR_COMMITMENT_LIMIT:
-               return EAGAIN;
-       case ERROR_CRC:
-               return EIO;
-       case ERROR_DEVICE_DOOR_OPEN:
-               return EIO;
-       case ERROR_DEVICE_IN_USE:
-               return EAGAIN;
-       case ERROR_DEVICE_REQUIRES_CLEANING:
-               return EIO;
-       case ERROR_DIRECTORY:
-               return ENOTDIR;
-       case ERROR_DIR_NOT_EMPTY:
-               return ENOTEMPTY;
-       case ERROR_DISK_CORRUPT:
-               return EIO;
-       case ERROR_DISK_FULL:
-               return ENOSPC;
-#ifdef ENOTUNIQ
-       case ERROR_DUP_NAME:
-               return ENOTUNIQ;
-#endif
-       case ERROR_EAS_DIDNT_FIT:
-               return ENOSPC;
-#ifdef ENOTSUP
-       case ERROR_EAS_NOT_SUPPORTED:
-               return ENOTSUP;
-#endif
-       case ERROR_EA_LIST_INCONSISTENT:
-               return EINVAL;
-       case ERROR_EA_TABLE_FULL:
-               return ENOSPC;
-       case ERROR_END_OF_MEDIA:
-               return ENOSPC;
-       case ERROR_EOM_OVERFLOW:
-               return EIO;
-       case ERROR_EXE_MACHINE_TYPE_MISMATCH:
-               return ENOEXEC;
-       case ERROR_EXE_MARKED_INVALID:
-               return ENOEXEC;
-       case ERROR_FILEMARK_DETECTED:
-               return EIO;
-       case ERROR_FILENAME_EXCED_RANGE:
-               return ENAMETOOLONG;
-       case ERROR_FILE_CORRUPT:
-               return EEXIST;
-       case ERROR_FILE_EXISTS:
-               return EEXIST;
-       case ERROR_FILE_INVALID:
-               return ENXIO;
-       case ERROR_FILE_NOT_FOUND:
-               return ENOENT;
-       case ERROR_HANDLE_DISK_FULL:
-               return ENOSPC;
-#ifdef ENODATA
-       case ERROR_HANDLE_EOF:
-               return ENODATA;
-#endif
-       case ERROR_INVALID_ADDRESS:
-               return EINVAL;
-       case ERROR_INVALID_AT_INTERRUPT_TIME:
-               return EINTR;
-       case ERROR_INVALID_BLOCK_LENGTH:
-               return EIO;
-       case ERROR_INVALID_DATA:
-               return EINVAL;
-       case ERROR_INVALID_DRIVE:
-               return ENODEV;
-       case ERROR_INVALID_EA_NAME:
-               return EINVAL;
-       case ERROR_INVALID_EXE_SIGNATURE:
-               return ENOEXEC;
-#ifdef EBADRQC
-       case ERROR_INVALID_FUNCTION:
-               return EBADRQC;
-#endif
-       case ERROR_INVALID_HANDLE:
-               return EBADF;
-       case ERROR_INVALID_NAME:
-               return ENOENT;
-       case ERROR_INVALID_PARAMETER:
-               return EINVAL;
-       case ERROR_INVALID_SIGNAL_NUMBER:
-               return EINVAL;
-       case ERROR_IOPL_NOT_ENABLED:
-               return ENOEXEC;
-       case ERROR_IO_DEVICE:
-               return EIO;
-       case ERROR_IO_INCOMPLETE:
-               return EAGAIN;
-       case ERROR_IO_PENDING:
-               return EAGAIN;
-       case ERROR_LOCK_VIOLATION:
-               return EBUSY;
-       case ERROR_MAX_THRDS_REACHED:
-               return EAGAIN;
-       case ERROR_META_EXPANSION_TOO_LONG:
-               return EINVAL;
-       case ERROR_MOD_NOT_FOUND:
-               return ENOENT;
-#ifdef EMSGSIZE
-       case ERROR_MORE_DATA:
-               return EMSGSIZE;
-#endif
-       case ERROR_NEGATIVE_SEEK:
-               return EINVAL;
-       case ERROR_NETNAME_DELETED:
-               return ENOENT;
-       case ERROR_NOACCESS:
-               return EFAULT;
-       case ERROR_NONE_MAPPED:
-               return EINVAL;
-       case ERROR_NONPAGED_SYSTEM_RESOURCES:
-               return EAGAIN;
-#ifdef ENOLINK
-       case ERROR_NOT_CONNECTED:
-               return ENOLINK;
-#endif
-       case ERROR_NOT_ENOUGH_MEMORY:
-               return ENOMEM;
-       case ERROR_NOT_OWNER:
-               return EPERM;
-#ifdef ENOMEDIUM
-       case ERROR_NOT_READY:
-               return ENOMEDIUM;
-#endif
-       case ERROR_NOT_SAME_DEVICE:
-               return EXDEV;
-       case ERROR_NOT_SUPPORTED:
-               return ENOSYS;
-       case ERROR_NO_DATA:
-               return EPIPE;
-       case ERROR_NO_DATA_DETECTED:
-               return EIO;
-#ifdef ENOMEDIUM
-       case ERROR_NO_MEDIA_IN_DRIVE:
-               return ENOMEDIUM;
-#endif
-#ifdef ENMFILE
-       case ERROR_NO_MORE_FILES:
-               return ENMFILE;
-#endif
-#ifdef ENMFILE
-       case ERROR_NO_MORE_ITEMS:
-               return ENMFILE;
-#endif
-       case ERROR_NO_MORE_SEARCH_HANDLES:
-               return ENFILE;
-       case ERROR_NO_PROC_SLOTS:
-               return EAGAIN;
-       case ERROR_NO_SIGNAL_SENT:
-               return EIO;
-       case ERROR_NO_SYSTEM_RESOURCES:
-               return EFBIG;
-       case ERROR_NO_TOKEN:
-               return EINVAL;
-       case ERROR_OPEN_FAILED:
-               return EIO;
-       case ERROR_OPEN_FILES:
-               return EAGAIN;
-       case ERROR_OUTOFMEMORY:
-               return ENOMEM;
-       case ERROR_PAGED_SYSTEM_RESOURCES:
-               return EAGAIN;
-       case ERROR_PAGEFILE_QUOTA:
-               return EAGAIN;
-       case ERROR_PATH_NOT_FOUND:
-               return ENOENT;
-       case ERROR_PIPE_BUSY:
-               return EBUSY;
-       case ERROR_PIPE_CONNECTED:
-               return EBUSY;
-#ifdef ECOMM
-       case ERROR_PIPE_LISTENING:
-               return ECOMM;
-       case ERROR_PIPE_NOT_CONNECTED:
-               return ECOMM;
-#endif
-       case ERROR_POSSIBLE_DEADLOCK:
-               return EDEADLOCK;
-       case ERROR_PRIVILEGE_NOT_HELD:
-               return EPERM;
-       case ERROR_PROCESS_ABORTED:
-               return EFAULT;
-       case ERROR_PROC_NOT_FOUND:
-               return ESRCH;
-#ifdef ENONET
-       case ERROR_REM_NOT_LIST:
-               return ENONET;
-#endif
-       case ERROR_SECTOR_NOT_FOUND:
-               return EINVAL;
-       case ERROR_SEEK:
-               return EINVAL;
-       case ERROR_SETMARK_DETECTED:
-               return EIO;
-       case ERROR_SHARING_BUFFER_EXCEEDED:
-               return ENOLCK;
-       case ERROR_SHARING_VIOLATION:
-               return EBUSY;
-       case ERROR_SIGNAL_PENDING:
-               return EBUSY;
-       case ERROR_SIGNAL_REFUSED:
-               return EIO;
-#ifdef ELIBBAD
-       case ERROR_SXS_CANT_GEN_ACTCTX:
-               return ELIBBAD;
-#endif
-       case ERROR_THREAD_1_INACTIVE:
-               return EINVAL;
-       case ERROR_TOO_MANY_LINKS:
-               return EMLINK;
-       case ERROR_TOO_MANY_OPEN_FILES:
-               return EMFILE;
-       case ERROR_WAIT_NO_CHILDREN:
-               return ECHILD;
-       case ERROR_WORKING_SET_QUOTA:
-               return EAGAIN;
-       case ERROR_WRITE_PROTECT:
-               return EROFS;
-       default:
-               return -1;
-       }
-}
-
-void
-set_errno_from_GetLastError(void)
-{
-       errno = win32_error_to_errno(GetLastError());
-}
-
-/* Given a Windows-style path, return the number of characters of the prefix
- * that specify the path to the root directory of a drive, or return 0 if the
- * drive is relative (or at least on the current drive, in the case of
- * absolute-but-not-really-absolute paths like \Windows\System32) */
-static size_t
-win32_path_drive_spec_len(const wchar_t *path)
-{
-       size_t n = 0;
-
-       if (!wcsncmp(path, L"\\\\?\\", 4)) {
-               /* \\?\-prefixed path.  Check for following drive letter and
-                * path separator. */
-               if (path[4] != L'\0' && path[5] == L':' &&
-                   is_any_path_separator(path[6]))
-                       n = 7;
-       } else {
-               /* Not a \\?\-prefixed path.  Check for an initial drive letter
-                * and path separator. */
-               if (path[0] != L'\0' && path[1] == L':' &&
-                   is_any_path_separator(path[2]))
-                       n = 3;
-       }
-       /* Include any additional path separators.*/
-       if (n > 0)
-               while (is_any_path_separator(path[n]))
-                       n++;
-       return n;
-}
-
-bool
-win32_path_is_root_of_drive(const wchar_t *path)
-{
-       size_t drive_spec_len;
-       wchar_t full_path[32768];
-       DWORD ret;
-
-       ret = GetFullPathName(path, ARRAY_LEN(full_path), full_path, NULL);
-       if (ret > 0 && ret < ARRAY_LEN(full_path))
-               path = full_path;
-
-       /* Explicit drive letter and path separator? */
-       drive_spec_len = win32_path_drive_spec_len(path);
-       if (drive_spec_len > 0 && path[drive_spec_len] == L'\0')
-               return true;
-
-       /* All path separators? */
-       for (const wchar_t *p = path; *p != L'\0'; p++)
-               if (!is_any_path_separator(*p))
-                       return false;
-       return true;
-}
-
-
-/* Given a path, which may not yet exist, get a set of flags that describe the
- * features of the volume the path is on. */
-int
-win32_get_vol_flags(const wchar_t *path, unsigned *vol_flags_ret,
-                   bool *supports_SetFileShortName_ret)
-{
-       wchar_t *volume;
-       BOOL bret;
-       DWORD vol_flags;
-       size_t drive_spec_len;
-       wchar_t filesystem_name[MAX_PATH + 1];
-
-       if (supports_SetFileShortName_ret)
-               *supports_SetFileShortName_ret = false;
-
-       drive_spec_len = win32_path_drive_spec_len(path);
-
-       if (drive_spec_len == 0)
-               if (path[0] != L'\0' && path[1] == L':') /* Drive-relative path? */
-                       drive_spec_len = 2;
-
-       if (drive_spec_len == 0) {
-               /* Path does not start with a drive letter; use the volume of
-                * the current working directory. */
-               volume = NULL;
-       } else {
-               /* Path starts with a drive letter (or \\?\ followed by a drive
-                * letter); use it. */
-               volume = alloca((drive_spec_len + 2) * sizeof(wchar_t));
-               wmemcpy(volume, path, drive_spec_len);
-               /* Add trailing backslash in case this was a drive-relative
-                * path. */
-               volume[drive_spec_len] = L'\\';
-               volume[drive_spec_len + 1] = L'\0';
-       }
-       bret = GetVolumeInformation(
-                       volume,                         /* lpRootPathName */
-                       NULL,                           /* lpVolumeNameBuffer */
-                       0,                              /* nVolumeNameSize */
-                       NULL,                           /* lpVolumeSerialNumber */
-                       NULL,                           /* lpMaximumComponentLength */
-                       &vol_flags,                     /* lpFileSystemFlags */
-                       filesystem_name,                /* lpFileSystemNameBuffer */
-                       ARRAY_LEN(filesystem_name));    /* nFileSystemNameSize */
-       if (!bret) {
-               DWORD err = GetLastError();
-               WARNING("Failed to get volume information for path \"%ls\"", path);
-               win32_error(err);
-               vol_flags = 0xffffffff;
-               goto out;
-       }
-
-       if (wcsstr(filesystem_name, L"NTFS")) {
-               /* FILE_SUPPORTS_HARD_LINKS is only supported on Windows 7 and later.
-                * Force it on anyway if filesystem is NTFS.  */
-               vol_flags |= FILE_SUPPORTS_HARD_LINKS;
-
-               if (supports_SetFileShortName_ret)
-                       *supports_SetFileShortName_ret = true;
-       }
-
-out:
-       DEBUG("using vol_flags = %x", vol_flags);
-       *vol_flags_ret = vol_flags;
-       return 0;
-}
+#include "wimlib/win32_vss.h"
 
 static bool
 win32_modify_privilege(const wchar_t *privilege, bool enable)
@@ -482,16 +64,21 @@ out:
 static bool
 win32_modify_capture_privileges(bool enable)
 {
-       return win32_modify_privilege(SE_BACKUP_NAME, enable)
-           && win32_modify_privilege(SE_SECURITY_NAME, enable);
+       bool ok = true;
+       ok &= win32_modify_privilege(SE_BACKUP_NAME, enable);
+       ok &= win32_modify_privilege(SE_SECURITY_NAME, enable);
+       return ok;
 }
 
 static bool
 win32_modify_apply_privileges(bool enable)
 {
-       return win32_modify_privilege(SE_RESTORE_NAME, enable)
-           && win32_modify_privilege(SE_SECURITY_NAME, enable)
-           && win32_modify_privilege(SE_TAKE_OWNERSHIP_NAME, enable);
+       bool ok = true;
+       ok &= win32_modify_privilege(SE_RESTORE_NAME, enable);
+       ok &= win32_modify_privilege(SE_SECURITY_NAME, enable);
+       ok &= win32_modify_privilege(SE_TAKE_OWNERSHIP_NAME, enable);
+       ok &= win32_modify_privilege(SE_MANAGE_VOLUME_NAME, enable);
+       return ok;
 }
 
 static void
@@ -501,114 +88,320 @@ win32_release_capture_and_apply_privileges(void)
        win32_modify_apply_privileges(false);
 }
 
-HANDLE
-win32_open_existing_file(const wchar_t *path, DWORD dwDesiredAccess)
-{
-       return CreateFileW(path,
-                          dwDesiredAccess,
-                          FILE_SHARE_READ,
-                          NULL, /* lpSecurityAttributes */
-                          OPEN_EXISTING,
-                          FILE_FLAG_BACKUP_SEMANTICS |
-                              FILE_FLAG_OPEN_REPARSE_POINT,
-                          NULL /* hTemplateFile */);
-}
-
-HANDLE
-win32_open_file_data_only(const wchar_t *path)
-{
-       return win32_open_existing_file(path, FILE_READ_DATA);
-}
+/* Pointers to dynamically loaded functions  */
 
-#ifndef WITH_NTDLL
-/* Pointers to functions that are not available on all targetted versions of
- * Windows (XP and later).  NOTE: The WINAPI annotations seem to be important; I
- * assume it specifies a certain calling convention. */
+NTSTATUS (WINAPI *func_RtlDosPathNameToNtPathName_U_WithStatus)
+               (IN PCWSTR DosName,
+                OUT PUNICODE_STRING NtName,
+                OUT PCWSTR *PartName,
+                OUT PRTL_RELATIVE_NAME_U RelativeName);
 
-/* Vista and later */
-HANDLE (WINAPI *win32func_FindFirstStreamW)(LPCWSTR lpFileName,
-                                           STREAM_INFO_LEVELS InfoLevel,
-                                           LPVOID lpFindStreamData,
-                                           DWORD dwFlags) = NULL;
+NTSTATUS (WINAPI *func_RtlCreateSystemVolumeInformationFolder)
+               (PCUNICODE_STRING VolumeRootPath);
 
-/* Vista and later */
-BOOL (WINAPI *win32func_FindNextStreamW)(HANDLE hFindStream,
-                                        LPVOID lpFindStreamData) = NULL;
-#endif /* !WITH_NTDLL */
+static bool acquired_privileges = false;
 
-/* Vista and later */
-BOOL (WINAPI *win32func_CreateSymbolicLinkW)(const wchar_t *lpSymlinkFileName,
-                                            const wchar_t *lpTargetFileName,
-                                            DWORD dwFlags) = NULL;
+static HMODULE ntdll_handle = NULL;
 
-static OSVERSIONINFO windows_version_info = {
-       .dwOSVersionInfoSize = sizeof(OSVERSIONINFO),
-};
+static int
+init_ntdll(void)
+{
+       ntdll_handle = LoadLibrary(L"ntdll.dll");
 
-static HMODULE hKernel32 = NULL;
+       if (!ntdll_handle) {
+               ERROR("Unable to load ntdll.dll");
+               return WIMLIB_ERR_UNSUPPORTED;
+       }
 
-static bool acquired_privileges = false;
+       func_RtlDosPathNameToNtPathName_U_WithStatus =
+               (void *)GetProcAddress(ntdll_handle,
+                                      "RtlDosPathNameToNtPathName_U_WithStatus");
 
-bool
-windows_version_is_at_least(unsigned major, unsigned minor)
-{
-       return windows_version_info.dwMajorVersion > major ||
-               (windows_version_info.dwMajorVersion == major &&
-                windows_version_info.dwMinorVersion >= minor);
+       func_RtlCreateSystemVolumeInformationFolder =
+               (void *)GetProcAddress(ntdll_handle,
+                                      "RtlCreateSystemVolumeInformationFolder");
+       return 0;
 }
 
 /* One-time initialization for Windows capture/apply code.  */
 int
 win32_global_init(int init_flags)
 {
+       int ret;
+
        /* Try to acquire useful privileges.  */
        if (!(init_flags & WIMLIB_INIT_FLAG_DONT_ACQUIRE_PRIVILEGES)) {
+               ret = WIMLIB_ERR_INSUFFICIENT_PRIVILEGES;
                if (!win32_modify_capture_privileges(true))
                        if (init_flags & WIMLIB_INIT_FLAG_STRICT_CAPTURE_PRIVILEGES)
-                               goto insufficient_privileges;
+                               goto out_drop_privs;
                if (!win32_modify_apply_privileges(true))
                        if (init_flags & WIMLIB_INIT_FLAG_STRICT_APPLY_PRIVILEGES)
-                               goto insufficient_privileges;
+                               goto out_drop_privs;
                acquired_privileges = true;
        }
 
-       /* Get Windows version information.  */
-       GetVersionEx(&windows_version_info);
-
-       /* Try to dynamically load some functions.  */
-       if (hKernel32 == NULL)
-               hKernel32 = LoadLibrary(L"Kernel32.dll");
-
-       if (hKernel32) {
-       #ifndef WITH_NTDLL
-               win32func_FindFirstStreamW = (void*)GetProcAddress(hKernel32,
-                                                                  "FindFirstStreamW");
-               if (win32func_FindFirstStreamW) {
-                       win32func_FindNextStreamW = (void*)GetProcAddress(hKernel32,
-                                                                         "FindNextStreamW");
-                       if (!win32func_FindNextStreamW)
-                               win32func_FindFirstStreamW = NULL;
-               }
-       #endif /* !WITH_NTDLL */
-               win32func_CreateSymbolicLinkW = (void*)GetProcAddress(hKernel32,
-                                                                     "CreateSymbolicLinkW");
-       }
+       ret = init_ntdll();
+       if (ret)
+               goto out_drop_privs;
+
        return 0;
 
-insufficient_privileges:
+out_drop_privs:
        win32_release_capture_and_apply_privileges();
-       return WIMLIB_ERR_INSUFFICIENT_PRIVILEGES;
+       return ret;
 }
 
 void
 win32_global_cleanup(void)
 {
+       vss_global_cleanup();
+
        if (acquired_privileges)
                win32_release_capture_and_apply_privileges();
-       if (hKernel32 != NULL) {
-               FreeLibrary(hKernel32);
-               hKernel32 = NULL;
+
+       FreeLibrary(ntdll_handle);
+       ntdll_handle = NULL;
+}
+
+/*
+ * Translates a Win32-namespace path into an NT-namespace path.
+ *
+ * On success, returns 0.  The NT-namespace path will be stored in the
+ * UNICODE_STRING structure pointed to by nt_path.  nt_path->Buffer will be set
+ * to a new buffer that must later be freed with HeapFree().  (Really
+ * RtlHeapFree(), but HeapFree() seems to be the same thing.)
+ *
+ * On failure, returns WIMLIB_ERR_NOMEM or WIMLIB_ERR_INVALID_PARAM.
+ */
+int
+win32_path_to_nt_path(const wchar_t *win32_path, UNICODE_STRING *nt_path)
+{
+       NTSTATUS status;
+
+       if (func_RtlDosPathNameToNtPathName_U_WithStatus) {
+               status = (*func_RtlDosPathNameToNtPathName_U_WithStatus)(win32_path,
+                                                                        nt_path,
+                                                                        NULL, NULL);
+       } else {
+               if (RtlDosPathNameToNtPathName_U(win32_path, nt_path, NULL, NULL))
+                       status = STATUS_SUCCESS;
+               else
+                       status = STATUS_NO_MEMORY;
+       }
+
+       if (likely(NT_SUCCESS(status)))
+               return 0;
+
+       if (status == STATUS_NO_MEMORY)
+               return WIMLIB_ERR_NOMEM;
+
+       winnt_error(status, L"\"%ls\": invalid path name", win32_path);
+       return WIMLIB_ERR_INVALID_PARAM;
+}
+
+int
+win32_get_drive_path(const wchar_t *file_path, wchar_t drive_path[7])
+{
+       tchar *file_abspath;
+
+       file_abspath = realpath(file_path, NULL);
+       if (!file_abspath)
+               return WIMLIB_ERR_NOMEM;
+
+       if (file_abspath[0] == L'\0' || file_abspath[1] != L':') {
+               ERROR("\"%ls\": Path format not recognized", file_abspath);
+               FREE(file_abspath);
+               return WIMLIB_ERR_UNSUPPORTED;
        }
+
+       wsprintf(drive_path, L"\\\\.\\%lc:", file_abspath[0]);
+       FREE(file_abspath);
+       return 0;
+}
+
+/* Try to attach an instance of the Windows Overlay Filesystem filter driver to
+ * the specified drive (such as C:)  */
+bool
+win32_try_to_attach_wof(const wchar_t *drive)
+{
+       HMODULE fltlib;
+       bool retval = false;
+
+       /* Use FilterAttach() from Fltlib.dll.  */
+
+       fltlib = LoadLibrary(L"Fltlib.dll");
+
+       if (!fltlib) {
+               WARNING("Failed to load Fltlib.dll");
+               return retval;
+       }
+
+       HRESULT (WINAPI *func_FilterAttach)(LPCWSTR lpFilterName,
+                                           LPCWSTR lpVolumeName,
+                                           LPCWSTR lpInstanceName,
+                                           DWORD dwCreatedInstanceNameLength,
+                                           LPWSTR lpCreatedInstanceName);
+
+       func_FilterAttach = (void *)GetProcAddress(fltlib, "FilterAttach");
+
+       if (func_FilterAttach) {
+               HRESULT res;
+
+               res = (*func_FilterAttach)(L"wof", drive, NULL, 0, NULL);
+
+               if (res != S_OK)
+                       res = (*func_FilterAttach)(L"wofadk", drive, NULL, 0, NULL);
+
+               if (res == S_OK)
+                       retval = true;
+       } else {
+               WARNING("FilterAttach() does not exist in Fltlib.dll");
+       }
+
+       FreeLibrary(fltlib);
+
+       return retval;
+}
+
+
+static void
+windows_msg(u32 code, const wchar_t *format, va_list va,
+           bool is_ntstatus, bool is_error)
+{
+       wchar_t _buf[STACK_MAX / 8];
+       wchar_t *buf = _buf;
+       size_t buflen = ARRAY_LEN(_buf);
+       size_t ret;
+       size_t n;
+
+retry:
+       n = vsnwprintf(buf, buflen, format, va);
+
+       if (n >= buflen)
+               goto realloc;
+
+       n += snwprintf(&buf[n], buflen - n,
+                      (is_ntstatus ?
+                       L" (status=%08"PRIx32"): " :
+                       L" (err=%"PRIu32"): "),
+                      code);
+
+       if (n >= buflen)
+               goto realloc;
+
+       ret = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM |
+                               FORMAT_MESSAGE_IGNORE_INSERTS |
+                               (is_ntstatus ? FORMAT_MESSAGE_FROM_HMODULE : 0),
+                           (is_ntstatus ? ntdll_handle : NULL),
+                           code,
+                           MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
+                           &buf[n],
+                           buflen - n,
+                           NULL);
+       n += ret;
+
+       if (n >= buflen || (ret == 0 && GetLastError() == ERROR_INSUFFICIENT_BUFFER))
+               goto realloc;
+
+        if (buf[n - 1] == L'\n')
+               buf[--n] = L'\0';
+        if (buf[n - 1] == L'\r')
+               buf[--n] = L'\0';
+        if (buf[n - 1] == L'.')
+               buf[--n] = L'\0';
+
+       if (is_error)
+               ERROR("%ls", buf);
+       else
+               WARNING("%ls", buf);
+       if (buf != _buf)
+               FREE(buf);
+       return;
+
+realloc:
+       if (buf != _buf)
+               FREE(buf);
+       buflen *= 2;
+       buf = MALLOC(buflen * sizeof(buf[0]));
+       if (buf)
+               goto retry;
+       ERROR("Ran out of memory while building error message!!!");
+}
+
+void
+win32_warning(DWORD err, const wchar_t *format, ...)
+{
+       va_list va;
+
+       va_start(va, format);
+       windows_msg(err, format, va, false, false);
+       va_end(va);
+}
+
+void
+win32_error(DWORD err, const wchar_t *format, ...)
+{
+       va_list va;
+
+       va_start(va, format);
+       windows_msg(err, format, va, false, true);
+       va_end(va);
+}
+
+void
+winnt_warning(NTSTATUS status, const wchar_t *format, ...)
+{
+       va_list va;
+
+       va_start(va, format);
+       windows_msg(status, format, va, true, false);
+       va_end(va);
+}
+
+void
+winnt_error(NTSTATUS status, const wchar_t *format, ...)
+{
+       va_list va;
+
+       va_start(va, format);
+       windows_msg(status, format, va, true, true);
+       va_end(va);
+}
+
+/*
+ * Synchronously execute a filesystem control method.  This is a wrapper around
+ * NtFsControlFile() that handles STATUS_PENDING.  Note that SYNCHRONIZE
+ * permission is, in general, required on the handle.
+ */
+NTSTATUS
+winnt_fsctl(HANDLE h, u32 code, const void *in, u32 in_size,
+           void *out, u32 out_size_avail, u32 *actual_out_size_ret)
+{
+       IO_STATUS_BLOCK iosb;
+       NTSTATUS status;
+
+       status = NtFsControlFile(h, NULL, NULL, NULL, &iosb, code,
+                                (void *)in, in_size, out, out_size_avail);
+       if (status == STATUS_PENDING) {
+               /* Beware: this case is often encountered with remote
+                * filesystems, but rarely with local filesystems.  */
+
+               status = NtWaitForSingleObject(h, FALSE, NULL);
+               if (NT_SUCCESS(status)) {
+                       status = iosb.Status;
+               } else {
+                       /* We shouldn't be issuing ioctls on a handle to which
+                        * we don't have SYNCHRONIZE access.  Otherwise we have
+                        * no way to wait for them to complete.  */
+                       wimlib_assert(status != STATUS_ACCESS_DENIED);
+               }
+       }
+
+       if (NT_SUCCESS(status) && actual_out_size_ret != NULL)
+               *actual_out_size_ret = (u32)iosb.Information;
+
+       return status;
 }
 
 #endif /* __WIN32__ */