ZenLib
OS_Utils.h
Go to the documentation of this file.
1 /* Copyright (c) MediaArea.net SARL. All Rights Reserved.
2  *
3  * Use of this source code is governed by a zlib-style license that can
4  * be found in the License.txt file in the root of the source tree.
5  */
6 
7 //---------------------------------------------------------------------------
8 #ifndef ZenOS_UtilsH
9 #define ZenOS_UtilsH
10 //---------------------------------------------------------------------------
11 
12 //---------------------------------------------------------------------------
13 #include "ZenLib/Ztring.h"
14 //---------------------------------------------------------------------------
15 
16 //---------------------------------------------------------------------------
17 #ifdef WINDOWS_UWP
18 #include <wrl.h>
19 #include <windows.foundation.h>
20 #include <windows.storage.h>
21 #endif
22 //---------------------------------------------------------------------------
23 
24 namespace ZenLib
25 {
26 
27 //***************************************************************************
28 // OS Information
29 //***************************************************************************
30 
31 //---------------------------------------------------------------------------
32 bool IsWin9X ();
33 // Execute
34 //***************************************************************************
35 
36 void Shell_Execute(const Ztring &ToExecute);
37 
38 //***************************************************************************
39 // File names
40 //***************************************************************************
41 
42 // Names for the narrow functions of the C library or of the system (e.g. fopen(), the arguments of main()), in the encoding of the locale
43 // (the code page on Windows), or UTF-8 where the file names are UTF-8 (e.g. macOS). Without Unicode, the strings of ZenLib, also the names
44 // it gives (e.g. Dir::GetAllFileNames()), are UTF-8 text: a name for these functions, or to show in the encoding of the locale, must be
45 // converted with FileName_To_Native() or Ztring::To_Local()
46 std::string FileName_To_Native(const Ztring &File_Name);
47 Ztring FileName_From_Native(const char* File_Name);
48 
49 //***************************************************************************
50 // Directorues
51 //***************************************************************************
52 
53 Ztring OpenFolder_Show(void* Handle, const Ztring &Title, const Ztring &Caption);
54 
55 //***************************************************************************
56 // WinRT Helpers
57 //***************************************************************************
58 #ifdef WINDOWS_UWP
59 template <typename T>
60 inline HRESULT Await(const Microsoft::WRL::ComPtr<T> &Operation)
61 {
62  if (!Operation)
63  return E_POINTER;
64 
65  Microsoft::WRL::ComPtr<ABI::Windows::Foundation::IAsyncInfo> Info;
66  HRESULT Result=Operation.As(&Info);
67  if (FAILED(Result))
68  return Result;
69 
70  ABI::Windows::Foundation::AsyncStatus Status;
71  while (SUCCEEDED(Result=Info->get_Status(&Status)) && Status==Started)
72  Sleep(0); //Yield
73 
74  if (FAILED(Result) || Status!=Completed) {
75  HRESULT Error_Code;
76  Result=Info->get_ErrorCode(&Error_Code);
77  if (FAILED(Result))
78  return Result;
79  return Error_Code;
80  }
81 
82  return Result;
83 }
84 
85 HRESULT Add_Item_To_FUA(Microsoft::WRL::Wrappers::HStringReference Path, Microsoft::WRL::ComPtr<ABI::Windows::Storage::IStorageItem> &Item);
86 HRESULT Get_File(Microsoft::WRL::Wrappers::HStringReference File_Name, Microsoft::WRL::ComPtr<ABI::Windows::Storage::IStorageFile> &File);
87 HRESULT Get_Folder(Microsoft::WRL::Wrappers::HStringReference Folder_Name, Microsoft::WRL::ComPtr<ABI::Windows::Storage::IStorageFolder> &Folder);
88 #endif
89 
90 } //namespace ZenLib
91 #endif
void Shell_Execute(const Ztring &ToExecute)
bool IsWin9X()
Definition: BitStream.h:23
Ztring FileName_From_Native(const char *File_Name)
std::string FileName_To_Native(const Ztring &File_Name)
Ztring OpenFolder_Show(void *Handle, const Ztring &Title, const Ztring &Caption)