include/pathcch.h

   1 /*
   2  * Copyright 2017 Michael Müller
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #define PATHCCH_NONE                            0x00
  20 #define PATHCCH_ALLOW_LONG_PATHS                0x01
  21 #define PATHCCH_FORCE_ENABLE_LONG_NAME_PROCESS  0x02
  22 #define PATHCCH_FORCE_DISABLE_LONG_NAME_PROCESS 0x04
  23 #define PATHCCH_DO_NOT_NORMALIZE_SEGMENTS       0x08
  24 #define PATHCCH_ENSURE_IS_EXTENDED_LENGTH_PATH  0x10
  25 #define PATHCCH_ENSURE_TRAILING_SLASH           0x20
  26
  27 #define PATHCCH_MAX_CCH 0x8000
  28
  29 HRESULT WINAPI PathAllocCanonicalize(const WCHAR *path_in, DWORD flags, WCHAR **path_out);
  30 HRESULT WINAPI PathAllocCombine(const WCHAR *path1, const WCHAR *path2, DWORD flags, WCHAR **out);
  31 HRESULT WINAPI PathCchAddBackslash(WCHAR *path, SIZE_T size);
  32 HRESULT WINAPI PathCchAddBackslashEx(WCHAR *path, SIZE_T size, WCHAR **end, SIZE_T *remaining);
  33 HRESULT WINAPI PathCchAddExtension(WCHAR *path, SIZE_T size, const WCHAR *extension);
  34 HRESULT WINAPI PathCchAppend(WCHAR *path1, SIZE_T size, const WCHAR *path2);
  35 HRESULT WINAPI PathCchAppendEx(WCHAR *path1, SIZE_T size, const WCHAR *path2, DWORD flags);
  36 HRESULT WINAPI PathCchCanonicalize(WCHAR *out, SIZE_T size, const WCHAR *in);
  37 HRESULT WINAPI PathCchCanonicalizeEx(WCHAR *out, SIZE_T size, const WCHAR *in, DWORD flags);
  38 HRESULT WINAPI PathCchCombine(WCHAR *out, SIZE_T size, const WCHAR *path1, const WCHAR *path2);
  39 HRESULT WINAPI PathCchCombineEx(WCHAR *out, SIZE_T size, const WCHAR *path1, const WCHAR *path2, DWORD flags);
  40 HRESULT WINAPI PathCchFindExtension(const WCHAR *path, SIZE_T size, const WCHAR **extension);
  41 BOOL    WINAPI PathCchIsRoot(const WCHAR *path);
  42 HRESULT WINAPI PathCchRemoveBackslash(WCHAR *path, SIZE_T path_size);
  43 HRESULT WINAPI PathCchRemoveBackslashEx(WCHAR *path, SIZE_T path_size, WCHAR **path_end, SIZE_T *free_size);
  44 HRESULT WINAPI PathCchRemoveExtension(WCHAR *path, SIZE_T size);
  45 HRESULT WINAPI PathCchRemoveFileSpec(WCHAR *path, SIZE_T size);
  46 HRESULT WINAPI PathCchRenameExtension(WCHAR *path, SIZE_T size, const WCHAR *extension);
  47 HRESULT WINAPI PathCchSkipRoot(const WCHAR *path, const WCHAR **root_end);
  48 HRESULT WINAPI PathCchStripPrefix(WCHAR *path, SIZE_T size);
  49 HRESULT WINAPI PathCchStripToRoot(WCHAR *path, SIZE_T size);
  50 BOOL    WINAPI PathIsUNCEx(const WCHAR *path, const WCHAR **server);