1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/utils.cpp
3 // Purpose: Various utilities
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
34 #include "wx/msw/registry.h"
35 #include "wx/apptrait.h"
36 #include "wx/dynlib.h"
37 #include "wx/dynload.h"
38 #include "wx/scopeguard.h"
39 #include "wx/filename.h"
41 #include "wx/confbase.h" // for wxExpandEnvVars()
43 #include "wx/msw/private.h" // includes <windows.h>
44 #include "wx/msw/missing.h" // for CHARSET_HANGUL
46 #if defined(__CYGWIN__)
47 //CYGWIN gives annoying warning about runtime stuff if we don't do this
48 # define USE_SYS_TYPES_FD_SET
49 # include <sys/types.h>
52 // Doesn't work with Cygwin at present
53 #if wxUSE_SOCKETS && (defined(__GNUWIN32_OLD__) || defined(__WXWINCE__) || defined(__CYGWIN32__))
54 // apparently we need to include winsock.h to get WSADATA and other stuff
55 // used in wxGetFullHostName() with the old mingw32 versions
59 #if !defined(__GNUWIN32__) && !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
67 #if defined(__CYGWIN__)
68 #include <sys/unistd.h>
70 #include <sys/cygwin.h> // for cygwin_conv_to_full_win32_path()
73 #ifdef __BORLANDC__ // Please someone tell me which version of Borland needs
74 // this (3.1 I believe) and how to test for it.
75 // If this works for Borland 4.0 as well, then no worries.
79 // VZ: there is some code using NetXXX() functions to get the full user name:
80 // I don't think it's a good idea because they don't work under Win95 and
81 // seem to return the same as wxGetUserId() under NT. If you really want
82 // to use them, just #define USE_NET_API
89 #if defined(__WIN32__) && !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
100 #if !(defined(_MSC_VER) && (_MSC_VER > 800))
105 // For wxKillAllChildren
106 #include <tlhelp32.h>
108 // ----------------------------------------------------------------------------
110 // ----------------------------------------------------------------------------
112 // In the WIN.INI file
113 #if (!defined(USE_NET_API) && !defined(__WXWINCE__)) || defined(__WXMICROWIN__)
114 static const wxChar WX_SECTION
[] = wxT("wxWindows");
117 #if (!defined(USE_NET_API) && !defined(__WXWINCE__))
118 static const wxChar eUSERNAME
[] = wxT("UserName");
121 WXDLLIMPEXP_DATA_BASE(const wxChar
*) wxUserResourceStr
= wxT("TEXT");
123 // ============================================================================
125 // ============================================================================
127 // ----------------------------------------------------------------------------
128 // get host name and related
129 // ----------------------------------------------------------------------------
131 // Get hostname only (without domain name)
132 bool wxGetHostName(wxChar
*buf
, int maxSize
)
134 #if defined(__WXWINCE__)
135 // GetComputerName() is not supported but the name seems to be stored in
136 // this location in the registry, at least for PPC2003 and WM5
138 wxRegKey
regKey(wxRegKey::HKLM
, wxT("Ident"));
139 if ( !regKey
.HasValue(wxT("Name")) ||
140 !regKey
.QueryValue(wxT("Name"), hostName
) )
143 wxStrlcpy(buf
, hostName
.wx_str(), maxSize
);
144 #else // !__WXWINCE__
145 DWORD nSize
= maxSize
;
146 if ( !::GetComputerName(buf
, &nSize
) )
148 wxLogLastError(wxT("GetComputerName"));
152 #endif // __WXWINCE__/!__WXWINCE__
157 // get full hostname (with domain name if possible)
158 bool wxGetFullHostName(wxChar
*buf
, int maxSize
)
160 #if !defined( __WXMICROWIN__) && wxUSE_DYNLIB_CLASS && wxUSE_SOCKETS
161 // TODO should use GetComputerNameEx() when available
163 // we don't want to always link with Winsock DLL as we might not use it at
164 // all, so load it dynamically here if needed (and don't complain if it is
165 // missing, we handle this)
168 wxDynamicLibrary
dllWinsock(wxT("ws2_32.dll"), wxDL_VERBATIM
);
169 if ( dllWinsock
.IsLoaded() )
171 typedef int (PASCAL
*WSAStartup_t
)(WORD
, WSADATA
*);
172 typedef int (PASCAL
*gethostname_t
)(char *, int);
173 typedef hostent
* (PASCAL
*gethostbyname_t
)(const char *);
174 typedef hostent
* (PASCAL
*gethostbyaddr_t
)(const char *, int , int);
175 typedef int (PASCAL
*WSACleanup_t
)(void);
177 #define LOAD_WINSOCK_FUNC(func) \
179 pfn ## func = (func ## _t)dllWinsock.GetSymbol(wxT(#func))
181 LOAD_WINSOCK_FUNC(WSAStartup
);
184 if ( pfnWSAStartup
&& pfnWSAStartup(MAKEWORD(1, 1), &wsa
) == 0 )
186 LOAD_WINSOCK_FUNC(gethostname
);
189 if ( pfngethostname
)
192 if ( pfngethostname(bufA
, WXSIZEOF(bufA
)) == 0 )
194 // gethostname() won't usually include the DNS domain name,
195 // for this we need to work a bit more
196 if ( !strchr(bufA
, '.') )
198 LOAD_WINSOCK_FUNC(gethostbyname
);
200 struct hostent
*pHostEnt
= pfngethostbyname
201 ? pfngethostbyname(bufA
)
206 // Windows will use DNS internally now
207 LOAD_WINSOCK_FUNC(gethostbyaddr
);
209 pHostEnt
= pfngethostbyaddr
210 ? pfngethostbyaddr(pHostEnt
->h_addr
,
217 host
= wxString::FromAscii(pHostEnt
->h_name
);
223 LOAD_WINSOCK_FUNC(WSACleanup
);
230 wxStrlcpy(buf
, host
.c_str(), maxSize
);
236 #endif // !__WXMICROWIN__
238 return wxGetHostName(buf
, maxSize
);
241 // Get user ID e.g. jacs
242 bool wxGetUserId(wxChar
*WXUNUSED_IN_WINCE(buf
),
243 int WXUNUSED_IN_WINCE(maxSize
))
245 #if defined(__WXWINCE__)
249 DWORD nSize
= maxSize
;
250 if ( ::GetUserName(buf
, &nSize
) == 0 )
252 // actually, it does happen on Win9x if the user didn't log on
253 DWORD res
= ::GetEnvironmentVariable(wxT("username"), buf
, maxSize
);
265 // Get user name e.g. Julian Smart
266 bool wxGetUserName(wxChar
*buf
, int maxSize
)
268 wxCHECK_MSG( buf
&& ( maxSize
> 0 ), false,
269 wxT("empty buffer in wxGetUserName") );
270 #if defined(__WXWINCE__) && wxUSE_REGKEY
272 wxRegKey
key(wxRegKey::HKCU
, wxT("ControlPanel\\Owner"));
273 if(!key
.Open(wxRegKey::Read
))
276 if(!key
.QueryValue(wxT("Owner"),name
))
278 wxStrlcpy(buf
, name
.c_str(), maxSize
);
280 #elif defined(USE_NET_API)
281 CHAR szUserName
[256];
282 if ( !wxGetUserId(szUserName
, WXSIZEOF(szUserName
)) )
285 // TODO how to get the domain name?
288 // the code is based on the MSDN example (also see KB article Q119670)
289 WCHAR wszUserName
[256]; // Unicode user name
290 WCHAR wszDomain
[256];
293 USER_INFO_2
*ui2
; // User structure
295 // Convert ANSI user name and domain to Unicode
296 MultiByteToWideChar( CP_ACP
, 0, szUserName
, strlen(szUserName
)+1,
297 wszUserName
, WXSIZEOF(wszUserName
) );
298 MultiByteToWideChar( CP_ACP
, 0, szDomain
, strlen(szDomain
)+1,
299 wszDomain
, WXSIZEOF(wszDomain
) );
301 // Get the computer name of a DC for the domain.
302 if ( NetGetDCName( NULL
, wszDomain
, &ComputerName
) != NERR_Success
)
304 wxLogError(wxT("Can not find domain controller"));
309 // Look up the user on the DC
310 NET_API_STATUS status
= NetUserGetInfo( (LPWSTR
)ComputerName
,
311 (LPWSTR
)&wszUserName
,
312 2, // level - we want USER_INFO_2
320 case NERR_InvalidComputer
:
321 wxLogError(wxT("Invalid domain controller name."));
325 case NERR_UserNotFound
:
326 wxLogError(wxT("Invalid user name '%s'."), szUserName
);
331 wxLogSysError(wxT("Can't get information about user"));
336 // Convert the Unicode full name to ANSI
337 WideCharToMultiByte( CP_ACP
, 0, ui2
->usri2_full_name
, -1,
338 buf
, maxSize
, NULL
, NULL
);
343 wxLogError(wxT("Couldn't look up full user name."));
346 #else // !USE_NET_API
347 // Could use NIS, MS-Mail or other site specific programs
348 // Use wxWidgets configuration data
349 bool ok
= GetProfileString(WX_SECTION
, eUSERNAME
, wxEmptyString
, buf
, maxSize
- 1) != 0;
352 ok
= wxGetUserId(buf
, maxSize
);
357 wxStrlcpy(buf
, wxT("Unknown User"), maxSize
);
364 const wxChar
* wxGetHomeDir(wxString
*pstr
)
366 wxString
& strDir
= *pstr
;
368 // first branch is for Cygwin
369 #if defined(__UNIX__) && !defined(__WINE__)
370 const wxChar
*szHome
= wxGetenv("HOME");
371 if ( szHome
== NULL
) {
373 wxLogWarning(_("can't find user's HOME, using current directory."));
379 // add a trailing slash if needed
380 if ( strDir
.Last() != wxT('/') )
384 // Cygwin returns unix type path but that does not work well
385 static wxChar windowsPath
[MAX_PATH
];
386 cygwin_conv_to_full_win32_path(strDir
, windowsPath
);
387 strDir
= windowsPath
;
389 #elif defined(__WXWINCE__)
394 // If we have a valid HOME directory, as is used on many machines that
395 // have unix utilities on them, we should use that.
396 const wxChar
*szHome
= wxGetenv(wxT("HOME"));
398 if ( szHome
!= NULL
)
402 else // no HOME, try HOMEDRIVE/PATH
404 szHome
= wxGetenv(wxT("HOMEDRIVE"));
405 if ( szHome
!= NULL
)
407 szHome
= wxGetenv(wxT("HOMEPATH"));
409 if ( szHome
!= NULL
)
413 // the idea is that under NT these variables have default values
414 // of "%systemdrive%:" and "\\". As we don't want to create our
415 // config files in the root directory of the system drive, we will
416 // create it in our program's dir. However, if the user took care
417 // to set HOMEPATH to something other than "\\", we suppose that he
418 // knows what he is doing and use the supplied value.
419 if ( wxStrcmp(szHome
, wxT("\\")) == 0 )
424 if ( strDir
.empty() )
426 // If we have a valid USERPROFILE directory, as is the case in
427 // Windows NT, 2000 and XP, we should use that as our home directory.
428 szHome
= wxGetenv(wxT("USERPROFILE"));
430 if ( szHome
!= NULL
)
434 if ( !strDir
.empty() )
436 // sometimes the value of HOME may be "%USERPROFILE%", so reexpand the
437 // value once again, it shouldn't hurt anyhow
438 strDir
= wxExpandEnvVars(strDir
);
440 else // fall back to the program directory
442 // extract the directory component of the program file name
443 wxFileName::SplitPath(wxGetFullModuleName(), &strDir
, NULL
, NULL
);
447 return strDir
.c_str();
450 wxString
wxGetUserHome(const wxString
& user
)
454 if ( user
.empty() || user
== wxGetUserId() )
460 bool wxGetDiskSpace(const wxString
& WXUNUSED_IN_WINCE(path
),
461 wxDiskspaceSize_t
*WXUNUSED_IN_WINCE(pTotal
),
462 wxDiskspaceSize_t
*WXUNUSED_IN_WINCE(pFree
))
471 // old w32api don't have ULARGE_INTEGER
472 #if defined(__WIN32__) && \
473 (!defined(__GNUWIN32__) || wxCHECK_W32API_VERSION( 0, 3 ))
474 // GetDiskFreeSpaceEx() is not available under original Win95, check for
476 typedef BOOL (WINAPI
*GetDiskFreeSpaceEx_t
)(LPCTSTR
,
482 pGetDiskFreeSpaceEx
= (GetDiskFreeSpaceEx_t
)::GetProcAddress
484 ::GetModuleHandle(wxT("kernel32.dll")),
486 "GetDiskFreeSpaceExW"
488 "GetDiskFreeSpaceExA"
492 if ( pGetDiskFreeSpaceEx
)
494 ULARGE_INTEGER bytesFree
, bytesTotal
;
496 // may pass the path as is, GetDiskFreeSpaceEx() is smart enough
497 if ( !pGetDiskFreeSpaceEx(path
.fn_str(),
502 wxLogLastError(wxT("GetDiskFreeSpaceEx"));
507 // ULARGE_INTEGER is a union of a 64 bit value and a struct containing
508 // two 32 bit fields which may be or may be not named - try to make it
509 // compile in all cases
510 #if defined(__BORLANDC__) && !defined(_ANONYMOUS_STRUCT)
518 *pTotal
= wxDiskspaceSize_t(UL(bytesTotal
).HighPart
, UL(bytesTotal
).LowPart
);
520 *pTotal
= wxDiskspaceSize_t(UL(bytesTotal
).LowPart
);
527 *pFree
= wxLongLong(UL(bytesFree
).HighPart
, UL(bytesFree
).LowPart
);
529 *pFree
= wxDiskspaceSize_t(UL(bytesFree
).LowPart
);
536 // there's a problem with drives larger than 2GB, GetDiskFreeSpaceEx()
537 // should be used instead - but if it's not available, fall back on
538 // GetDiskFreeSpace() nevertheless...
540 DWORD lSectorsPerCluster
,
542 lNumberOfFreeClusters
,
543 lTotalNumberOfClusters
;
545 // FIXME: this is wrong, we should extract the root drive from path
546 // instead, but this is the job for wxFileName...
547 if ( !::GetDiskFreeSpace(path
.fn_str(),
550 &lNumberOfFreeClusters
,
551 &lTotalNumberOfClusters
) )
553 wxLogLastError(wxT("GetDiskFreeSpace"));
558 wxDiskspaceSize_t lBytesPerCluster
= (wxDiskspaceSize_t
) lSectorsPerCluster
;
559 lBytesPerCluster
*= lBytesPerSector
;
563 *pTotal
= lBytesPerCluster
;
564 *pTotal
*= lTotalNumberOfClusters
;
569 *pFree
= lBytesPerCluster
;
570 *pFree
*= lNumberOfFreeClusters
;
579 // ----------------------------------------------------------------------------
581 // ----------------------------------------------------------------------------
583 bool wxGetEnv(const wxString
& WXUNUSED_IN_WINCE(var
),
584 wxString
*WXUNUSED_IN_WINCE(value
))
587 // no environment variables under CE
590 // first get the size of the buffer
591 DWORD dwRet
= ::GetEnvironmentVariable(var
.t_str(), NULL
, 0);
594 // this means that there is no such variable
600 (void)::GetEnvironmentVariable(var
.t_str(),
601 wxStringBuffer(*value
, dwRet
),
609 bool wxDoSetEnv(const wxString
& var
, const wxChar
*value
)
612 // no environment variables under CE
616 #else // !__WXWINCE__
617 // update the CRT environment if possible as people expect getenv() to also
618 // work and it is not affected by Win32 SetEnvironmentVariable() call (OTOH
619 // the CRT does use Win32 call to update the process environment block so
620 // there is no need to call it)
622 // TODO: add checks for the other compilers (and update wxSetEnv()
623 // documentation in interface/wx/utils.h accordingly)
624 #if defined(__VISUALC__)
625 // notice that Microsoft _putenv() has different semantics from POSIX
626 // function with almost the same name: in particular it makes a copy of the
627 // string instead of using it as part of environment so we can safely call
628 // it here without going through all the troubles with wxSetEnvModule as in
629 // src/unix/utilsunx.cpp
630 wxString envstr
= var
;
634 _tputenv(envstr
.t_str());
635 #else // other compiler
636 if ( !::SetEnvironmentVariable(var
.t_str(), value
) )
638 wxLogLastError(wxT("SetEnvironmentVariable"));
645 #endif // __WXWINCE__/!__WXWINCE__
648 bool wxSetEnv(const wxString
& variable
, const wxString
& value
)
650 return wxDoSetEnv(variable
, value
.t_str());
653 bool wxUnsetEnv(const wxString
& variable
)
655 return wxDoSetEnv(variable
, NULL
);
658 // ----------------------------------------------------------------------------
659 // process management
660 // ----------------------------------------------------------------------------
662 // structure used to pass parameters from wxKill() to wxEnumFindByPidProc()
663 struct wxFindByPidParams
665 wxFindByPidParams() { hwnd
= 0; pid
= 0; }
667 // the HWND used to return the result
670 // the PID we're looking from
673 wxDECLARE_NO_COPY_CLASS(wxFindByPidParams
);
676 // wxKill helper: EnumWindows() callback which is used to find the first (top
677 // level) window belonging to the given process
678 BOOL CALLBACK
wxEnumFindByPidProc(HWND hwnd
, LPARAM lParam
)
681 (void)::GetWindowThreadProcessId(hwnd
, &pid
);
683 wxFindByPidParams
*params
= (wxFindByPidParams
*)lParam
;
684 if ( pid
== params
->pid
)
686 // remember the window we found
689 // return FALSE to stop the enumeration
693 // continue enumeration
697 int wxKillAllChildren(long pid
, wxSignal sig
, wxKillError
*krc
);
699 int wxKill(long pid
, wxSignal sig
, wxKillError
*krc
, int flags
)
701 if (flags
& wxKILL_CHILDREN
)
702 wxKillAllChildren(pid
, sig
, krc
);
704 // get the process handle to operate on
705 HANDLE hProcess
= ::OpenProcess(SYNCHRONIZE
|
707 PROCESS_QUERY_INFORMATION
,
708 FALSE
, // not inheritable
710 if ( hProcess
== NULL
)
714 // recognize wxKILL_ACCESS_DENIED as special because this doesn't
715 // mean that the process doesn't exist and this is important for
716 // wxProcess::Exists()
717 *krc
= ::GetLastError() == ERROR_ACCESS_DENIED
718 ? wxKILL_ACCESS_DENIED
725 wxON_BLOCK_EXIT1(::CloseHandle
, hProcess
);
731 // kill the process forcefully returning -1 as error code
732 if ( !::TerminateProcess(hProcess
, (UINT
)-1) )
734 wxLogSysError(_("Failed to kill process %d"), pid
);
738 // this is not supposed to happen if we could open the
748 // do nothing, we just want to test for process existence
754 // any other signal means "terminate"
756 wxFindByPidParams params
;
757 params
.pid
= (DWORD
)pid
;
759 // EnumWindows() has nice semantics: it returns 0 if it found
760 // something or if an error occurred and non zero if it
761 // enumerated all the window
762 if ( !::EnumWindows(wxEnumFindByPidProc
, (LPARAM
)¶ms
) )
764 // did we find any window?
767 // tell the app to close
769 // NB: this is the harshest way, the app won't have an
770 // opportunity to save any files, for example, but
771 // this is probably what we want here. If not we
772 // can also use SendMesageTimeout(WM_CLOSE)
773 if ( !::PostMessage(params
.hwnd
, WM_QUIT
, 0, 0) )
775 wxLogLastError(wxT("PostMessage(WM_QUIT)"));
778 else // it was an error then
780 wxLogLastError(wxT("EnumWindows"));
785 else // no windows for this PID
796 DWORD rc
wxDUMMY_INITIALIZE(0);
799 // as we wait for a short time, we can use just WaitForSingleObject()
800 // and not MsgWaitForMultipleObjects()
801 switch ( ::WaitForSingleObject(hProcess
, 500 /* msec */) )
804 // process terminated
805 if ( !::GetExitCodeProcess(hProcess
, &rc
) )
807 wxLogLastError(wxT("GetExitCodeProcess"));
812 wxFAIL_MSG( wxT("unexpected WaitForSingleObject() return") );
816 wxLogLastError(wxT("WaitForSingleObject"));
829 // the return code is the same as from Unix kill(): 0 if killed
830 // successfully or -1 on error
831 if ( !ok
|| rc
== STILL_ACTIVE
)
840 typedef HANDLE (WINAPI
*CreateToolhelp32Snapshot_t
)(DWORD
,DWORD
);
841 typedef BOOL (WINAPI
*Process32_t
)(HANDLE
,LPPROCESSENTRY32
);
843 CreateToolhelp32Snapshot_t lpfCreateToolhelp32Snapshot
;
844 Process32_t lpfProcess32First
, lpfProcess32Next
;
846 static void InitToolHelp32()
848 static bool s_initToolHelpDone
= false;
850 if (s_initToolHelpDone
)
853 s_initToolHelpDone
= true;
855 lpfCreateToolhelp32Snapshot
= NULL
;
856 lpfProcess32First
= NULL
;
857 lpfProcess32Next
= NULL
;
859 #if wxUSE_DYNLIB_CLASS
861 wxDynamicLibrary
dllKernel(wxT("kernel32.dll"), wxDL_VERBATIM
);
863 // Get procedure addresses.
864 // We are linking to these functions of Kernel32
865 // explicitly, because otherwise a module using
866 // this code would fail to load under Windows NT,
867 // which does not have the Toolhelp32
868 // functions in the Kernel 32.
869 lpfCreateToolhelp32Snapshot
=
870 (CreateToolhelp32Snapshot_t
)dllKernel
.RawGetSymbol(wxT("CreateToolhelp32Snapshot"));
873 (Process32_t
)dllKernel
.RawGetSymbol(wxT("Process32First"));
876 (Process32_t
)dllKernel
.RawGetSymbol(wxT("Process32Next"));
878 #endif // wxUSE_DYNLIB_CLASS
882 int wxKillAllChildren(long pid
, wxSignal sig
, wxKillError
*krc
)
889 // If not implemented for this platform (e.g. NT 4.0), silently ignore
890 if (!lpfCreateToolhelp32Snapshot
|| !lpfProcess32First
|| !lpfProcess32Next
)
893 // Take a snapshot of all processes in the system.
894 HANDLE hProcessSnap
= lpfCreateToolhelp32Snapshot(TH32CS_SNAPPROCESS
, 0);
895 if (hProcessSnap
== INVALID_HANDLE_VALUE
) {
901 //Fill in the size of the structure before using it.
904 pe
.dwSize
= sizeof(PROCESSENTRY32
);
906 // Walk the snapshot of the processes, and for each process,
907 // kill it if its parent is pid.
908 if (!lpfProcess32First(hProcessSnap
, &pe
)) {
909 // Can't get first process.
912 CloseHandle (hProcessSnap
);
917 if (pe
.th32ParentProcessID
== (DWORD
) pid
) {
918 if (wxKill(pe
.th32ProcessID
, sig
, krc
))
921 } while (lpfProcess32Next (hProcessSnap
, &pe
));
927 // Execute a program in an Interactive Shell
928 bool wxShell(const wxString
& command
)
935 wxChar
*shell
= wxGetenv(wxT("COMSPEC"));
937 shell
= (wxChar
*) wxT("\\COMMAND.COM");
946 // pass the command to execute to the command processor
947 cmd
.Printf(wxT("%s /c %s"), shell
, command
.c_str());
951 return wxExecute(cmd
, wxEXEC_SYNC
) == 0;
954 // Shutdown or reboot the PC
955 bool wxShutdown(int WXUNUSED_IN_WINCE(flags
))
960 #elif defined(__WIN32__)
963 if ( wxGetOsVersion(NULL
, NULL
) == wxOS_WINDOWS_NT
) // if is NT or 2K
965 // Get a token for this process.
967 bOK
= ::OpenProcessToken(GetCurrentProcess(),
968 TOKEN_ADJUST_PRIVILEGES
| TOKEN_QUERY
,
972 TOKEN_PRIVILEGES tkp
;
974 // Get the LUID for the shutdown privilege.
975 bOK
= ::LookupPrivilegeValue(NULL
, SE_SHUTDOWN_NAME
,
976 &tkp
.Privileges
[0].Luid
) != 0;
980 tkp
.PrivilegeCount
= 1; // one privilege to set
981 tkp
.Privileges
[0].Attributes
= SE_PRIVILEGE_ENABLED
;
983 // Get the shutdown privilege for this process.
984 ::AdjustTokenPrivileges(hToken
, FALSE
, &tkp
, 0,
985 (PTOKEN_PRIVILEGES
)NULL
, 0);
987 // Cannot test the return value of AdjustTokenPrivileges.
988 bOK
= ::GetLastError() == ERROR_SUCCESS
;
991 ::CloseHandle(hToken
);
998 if ( flags
& wxSHUTDOWN_FORCE
)
1001 flags
&= ~wxSHUTDOWN_FORCE
;
1006 case wxSHUTDOWN_POWEROFF
:
1007 wFlags
|= EWX_POWEROFF
;
1010 case wxSHUTDOWN_REBOOT
:
1011 wFlags
|= EWX_REBOOT
;
1014 case wxSHUTDOWN_LOGOFF
:
1015 wFlags
|= EWX_LOGOFF
;
1019 wxFAIL_MSG( wxT("unknown wxShutdown() flag") );
1023 bOK
= ::ExitWindowsEx(wFlags
, 0) != 0;
1027 #endif // WinCE/!WinCE
1030 // ----------------------------------------------------------------------------
1032 // ----------------------------------------------------------------------------
1034 // Get free memory in bytes, or -1 if cannot determine amount (e.g. on UNIX)
1035 wxMemorySize
wxGetFreeMemory()
1037 #if defined(__WIN64__)
1038 MEMORYSTATUSEX memStatex
;
1039 memStatex
.dwLength
= sizeof (memStatex
);
1040 ::GlobalMemoryStatusEx (&memStatex
);
1041 return (wxMemorySize
)memStatex
.ullAvailPhys
;
1042 #else /* if defined(__WIN32__) */
1043 MEMORYSTATUS memStatus
;
1044 memStatus
.dwLength
= sizeof(MEMORYSTATUS
);
1045 ::GlobalMemoryStatus(&memStatus
);
1046 return (wxMemorySize
)memStatus
.dwAvailPhys
;
1050 unsigned long wxGetProcessId()
1052 return ::GetCurrentProcessId();
1058 ::MessageBeep((UINT
)-1); // default sound
1061 bool wxIsDebuggerRunning()
1063 #if wxUSE_DYNLIB_CLASS
1064 // IsDebuggerPresent() is not available under Win95, so load it dynamically
1065 wxDynamicLibrary
dll(wxT("kernel32.dll"), wxDL_VERBATIM
);
1067 typedef BOOL (WINAPI
*IsDebuggerPresent_t
)();
1068 if ( !dll
.HasSymbol(wxT("IsDebuggerPresent")) )
1070 // no way to know, assume no
1074 return (*(IsDebuggerPresent_t
)dll
.GetSymbol(wxT("IsDebuggerPresent")))() != 0;
1080 // ----------------------------------------------------------------------------
1081 // working with MSW resources
1082 // ----------------------------------------------------------------------------
1085 wxLoadUserResource(const void **outData
,
1087 const wxString
& resourceName
,
1088 const wxString
& resourceType
,
1089 WXHINSTANCE instance
)
1091 wxCHECK_MSG( outData
&& outLen
, false, "output pointers can't be NULL" );
1093 HRSRC hResource
= ::FindResource(instance
,
1094 resourceName
.wx_str(),
1095 resourceType
.wx_str());
1099 HGLOBAL hData
= ::LoadResource(instance
, hResource
);
1102 wxLogSysError(_("Failed to load resource \"%s\"."), resourceName
);
1106 *outData
= ::LockResource(hData
);
1109 wxLogSysError(_("Failed to lock resource \"%s\"."), resourceName
);
1113 *outLen
= ::SizeofResource(instance
, hResource
);
1115 // Notice that we do not need to call neither UnlockResource() (which is
1116 // obsolete in Win32) nor GlobalFree() (resources are freed on process
1117 // termination only)
1123 wxLoadUserResource(const wxString
& resourceName
,
1124 const wxString
& resourceType
,
1126 WXHINSTANCE instance
)
1130 if ( !wxLoadUserResource(&data
, &len
, resourceName
, resourceType
, instance
) )
1133 char *s
= new char[len
+ 1];
1134 memcpy(s
, data
, len
);
1135 s
[len
] = '\0'; // NUL-terminate in case the resource itself wasn't
1143 // ----------------------------------------------------------------------------
1145 // ----------------------------------------------------------------------------
1147 // check if we're running under a server or workstation Windows system: it
1148 // returns true or false with obvious meaning as well as -1 if the system type
1149 // couldn't be determined
1151 // this function is currently private but we may want to expose it later if
1152 // it's really useful
1156 int wxIsWindowsServer()
1158 #ifdef VER_NT_WORKSTATION
1159 OSVERSIONINFOEX info
;
1162 info
.dwOSVersionInfoSize
= sizeof(info
);
1163 if ( ::GetVersionEx(reinterpret_cast<OSVERSIONINFO
*>(&info
)) )
1165 switch ( info
.wProductType
)
1167 case VER_NT_WORKSTATION
:
1171 case VER_NT_DOMAIN_CONTROLLER
:
1175 #endif // VER_NT_WORKSTATION
1180 } // anonymous namespace
1182 wxString
wxGetOsDescription()
1189 info
.dwOSVersionInfoSize
= sizeof(OSVERSIONINFO
);
1190 if ( ::GetVersionEx(&info
) )
1192 switch ( info
.dwPlatformId
)
1194 #ifdef VER_PLATFORM_WIN32_CE
1195 case VER_PLATFORM_WIN32_CE
:
1196 str
.Printf(_("Windows CE (%d.%d)"),
1197 info
.dwMajorVersion
,
1198 info
.dwMinorVersion
);
1201 case VER_PLATFORM_WIN32s
:
1202 str
= _("Win32s on Windows 3.1");
1205 case VER_PLATFORM_WIN32_WINDOWS
:
1206 switch (info
.dwMinorVersion
)
1209 if ( info
.szCSDVersion
[1] == 'B' ||
1210 info
.szCSDVersion
[1] == 'C' )
1212 str
= _("Windows 95 OSR2");
1216 str
= _("Windows 95");
1220 if ( info
.szCSDVersion
[1] == 'B' ||
1221 info
.szCSDVersion
[1] == 'C' )
1223 str
= _("Windows 98 SE");
1227 str
= _("Windows 98");
1231 str
= _("Windows ME");
1234 str
.Printf(_("Windows 9x (%d.%d)"),
1235 info
.dwMajorVersion
,
1236 info
.dwMinorVersion
);
1239 if ( !wxIsEmpty(info
.szCSDVersion
) )
1241 str
<< wxT(" (") << info
.szCSDVersion
<< wxT(')');
1245 case VER_PLATFORM_WIN32_NT
:
1246 switch ( info
.dwMajorVersion
)
1249 switch ( info
.dwMinorVersion
)
1252 str
.Printf(_("Windows 2000 (build %lu"),
1253 info
.dwBuildNumber
);
1257 // we can't distinguish between XP 64 and 2003
1258 // as they both are 5.2, so examine the product
1259 // type to resolve this ambiguity
1260 if ( wxIsWindowsServer() == 1 )
1262 str
.Printf(_("Windows Server 2003 (build %lu"),
1263 info
.dwBuildNumber
);
1266 //else: must be XP, fall through
1269 str
.Printf(_("Windows XP (build %lu"),
1270 info
.dwBuildNumber
);
1276 if ( info
.dwMinorVersion
== 0 )
1278 str
.Printf(_("Windows Vista (build %lu"),
1279 info
.dwBuildNumber
);
1286 str
.Printf(_("Windows NT %lu.%lu (build %lu"),
1287 info
.dwMajorVersion
,
1288 info
.dwMinorVersion
,
1289 info
.dwBuildNumber
);
1292 if ( !wxIsEmpty(info
.szCSDVersion
) )
1294 str
<< wxT(", ") << info
.szCSDVersion
;
1298 if ( wxIsPlatform64Bit() )
1299 str
<< _(", 64-bit edition");
1305 wxFAIL_MSG( wxT("GetVersionEx() failed") ); // should never happen
1311 bool wxIsPlatform64Bit()
1314 return true; // 64-bit programs run only on Win64
1315 #elif wxUSE_DYNLIB_CLASS // Win32
1316 // 32-bit programs run on both 32-bit and 64-bit Windows so check
1317 typedef BOOL (WINAPI
*IsWow64Process_t
)(HANDLE
, BOOL
*);
1319 wxDynamicLibrary
dllKernel32(wxT("kernel32.dll"));
1320 IsWow64Process_t pfnIsWow64Process
=
1321 (IsWow64Process_t
)dllKernel32
.RawGetSymbol(wxT("IsWow64Process"));
1324 if ( pfnIsWow64Process
)
1326 pfnIsWow64Process(::GetCurrentProcess(), &wow64
);
1328 //else: running under a system without Win64 support
1330 return wow64
!= FALSE
;
1333 #endif // Win64/Win32
1336 wxOperatingSystemId
wxGetOsVersion(int *verMaj
, int *verMin
)
1340 // this may be false, true or -1 if we tried to initialize but failed
1343 wxOperatingSystemId os
;
1349 // query the OS info only once as it's not supposed to change
1350 if ( !s_version
.initialized
)
1354 info
.dwOSVersionInfoSize
= sizeof(info
);
1355 if ( ::GetVersionEx(&info
) )
1357 s_version
.initialized
= true;
1359 #if defined(__WXWINCE__)
1360 s_version
.os
= wxOS_WINDOWS_CE
;
1361 #elif defined(__WXMICROWIN__)
1362 s_version
.os
= wxOS_WINDOWS_MICRO
;
1363 #else // "normal" desktop Windows system, use run-time detection
1364 switch ( info
.dwPlatformId
)
1366 case VER_PLATFORM_WIN32_NT
:
1367 s_version
.os
= wxOS_WINDOWS_NT
;
1370 case VER_PLATFORM_WIN32_WINDOWS
:
1371 s_version
.os
= wxOS_WINDOWS_9X
;
1374 #endif // Windows versions
1376 s_version
.verMaj
= info
.dwMajorVersion
;
1377 s_version
.verMin
= info
.dwMinorVersion
;
1379 else // GetVersionEx() failed
1381 s_version
.initialized
= -1;
1385 if ( s_version
.initialized
== 1 )
1388 *verMaj
= s_version
.verMaj
;
1390 *verMin
= s_version
.verMin
;
1393 // this works even if we were not initialized successfully as the initial
1394 // values of this field is 0 which is wxOS_UNKNOWN and exactly what we need
1395 return s_version
.os
;
1398 wxWinVersion
wxGetWinVersion()
1402 switch ( wxGetOsVersion(&verMaj
, &verMin
) )
1404 case wxOS_WINDOWS_9X
:
1410 return wxWinVersion_95
;
1413 return wxWinVersion_98
;
1416 return wxWinVersion_ME
;
1421 case wxOS_WINDOWS_NT
:
1425 return wxWinVersion_NT3
;
1428 return wxWinVersion_NT4
;
1434 return wxWinVersion_2000
;
1437 return wxWinVersion_XP
;
1440 return wxWinVersion_2003
;
1445 return wxWinVersion_NT6
;
1450 // Do nothing just to silence GCC warning
1454 return wxWinVersion_Unknown
;
1457 // ----------------------------------------------------------------------------
1459 // ----------------------------------------------------------------------------
1461 void wxMilliSleep(unsigned long milliseconds
)
1463 ::Sleep(milliseconds
);
1466 void wxMicroSleep(unsigned long microseconds
)
1468 wxMilliSleep(microseconds
/1000);
1471 void wxSleep(int nSecs
)
1473 wxMilliSleep(1000*nSecs
);
1476 // ----------------------------------------------------------------------------
1477 // font encoding <-> Win32 codepage conversion functions
1478 // ----------------------------------------------------------------------------
1480 extern WXDLLIMPEXP_BASE
long wxEncodingToCharset(wxFontEncoding encoding
)
1484 // although this function is supposed to return an exact match, do do
1485 // some mappings here for the most common case of "standard" encoding
1486 case wxFONTENCODING_SYSTEM
:
1487 return DEFAULT_CHARSET
;
1489 case wxFONTENCODING_ISO8859_1
:
1490 case wxFONTENCODING_ISO8859_15
:
1491 case wxFONTENCODING_CP1252
:
1492 return ANSI_CHARSET
;
1494 #if !defined(__WXMICROWIN__)
1495 // The following four fonts are multi-byte charsets
1496 case wxFONTENCODING_CP932
:
1497 return SHIFTJIS_CHARSET
;
1499 case wxFONTENCODING_CP936
:
1500 return GB2312_CHARSET
;
1503 case wxFONTENCODING_CP949
:
1504 return HANGUL_CHARSET
;
1507 case wxFONTENCODING_CP950
:
1508 return CHINESEBIG5_CHARSET
;
1510 // The rest are single byte encodings
1511 case wxFONTENCODING_CP1250
:
1512 return EASTEUROPE_CHARSET
;
1514 case wxFONTENCODING_CP1251
:
1515 return RUSSIAN_CHARSET
;
1517 case wxFONTENCODING_CP1253
:
1518 return GREEK_CHARSET
;
1520 case wxFONTENCODING_CP1254
:
1521 return TURKISH_CHARSET
;
1523 case wxFONTENCODING_CP1255
:
1524 return HEBREW_CHARSET
;
1526 case wxFONTENCODING_CP1256
:
1527 return ARABIC_CHARSET
;
1529 case wxFONTENCODING_CP1257
:
1530 return BALTIC_CHARSET
;
1532 case wxFONTENCODING_CP874
:
1533 return THAI_CHARSET
;
1534 #endif // !__WXMICROWIN__
1536 case wxFONTENCODING_CP437
:
1540 // no way to translate this encoding into a Windows charset
1545 // we have 2 versions of wxCharsetToCodepage(): the old one which directly
1546 // looks up the vlaues in the registry and the new one which is more
1547 // politically correct and has more chances to work on other Windows versions
1548 // as well but the old version is still needed for !wxUSE_FONTMAP case
1551 #include "wx/fontmap.h"
1553 extern WXDLLIMPEXP_BASE
long wxEncodingToCodepage(wxFontEncoding encoding
)
1555 // There don't seem to be symbolic names for
1556 // these under Windows so I just copied the
1557 // values from MSDN.
1563 case wxFONTENCODING_ISO8859_1
: ret
= 28591; break;
1564 case wxFONTENCODING_ISO8859_2
: ret
= 28592; break;
1565 case wxFONTENCODING_ISO8859_3
: ret
= 28593; break;
1566 case wxFONTENCODING_ISO8859_4
: ret
= 28594; break;
1567 case wxFONTENCODING_ISO8859_5
: ret
= 28595; break;
1568 case wxFONTENCODING_ISO8859_6
: ret
= 28596; break;
1569 case wxFONTENCODING_ISO8859_7
: ret
= 28597; break;
1570 case wxFONTENCODING_ISO8859_8
: ret
= 28598; break;
1571 case wxFONTENCODING_ISO8859_9
: ret
= 28599; break;
1572 case wxFONTENCODING_ISO8859_10
: ret
= 28600; break;
1573 case wxFONTENCODING_ISO8859_11
: ret
= 874; break;
1574 // case wxFONTENCODING_ISO8859_12, // doesn't exist currently, but put it
1575 case wxFONTENCODING_ISO8859_13
: ret
= 28603; break;
1576 // case wxFONTENCODING_ISO8859_14: ret = 28604; break; // no correspondence on Windows
1577 case wxFONTENCODING_ISO8859_15
: ret
= 28605; break;
1579 case wxFONTENCODING_KOI8
: ret
= 20866; break;
1580 case wxFONTENCODING_KOI8_U
: ret
= 21866; break;
1582 case wxFONTENCODING_CP437
: ret
= 437; break;
1583 case wxFONTENCODING_CP850
: ret
= 850; break;
1584 case wxFONTENCODING_CP852
: ret
= 852; break;
1585 case wxFONTENCODING_CP855
: ret
= 855; break;
1586 case wxFONTENCODING_CP866
: ret
= 866; break;
1587 case wxFONTENCODING_CP874
: ret
= 874; break;
1588 case wxFONTENCODING_CP932
: ret
= 932; break;
1589 case wxFONTENCODING_CP936
: ret
= 936; break;
1590 case wxFONTENCODING_CP949
: ret
= 949; break;
1591 case wxFONTENCODING_CP950
: ret
= 950; break;
1592 case wxFONTENCODING_CP1250
: ret
= 1250; break;
1593 case wxFONTENCODING_CP1251
: ret
= 1251; break;
1594 case wxFONTENCODING_CP1252
: ret
= 1252; break;
1595 case wxFONTENCODING_CP1253
: ret
= 1253; break;
1596 case wxFONTENCODING_CP1254
: ret
= 1254; break;
1597 case wxFONTENCODING_CP1255
: ret
= 1255; break;
1598 case wxFONTENCODING_CP1256
: ret
= 1256; break;
1599 case wxFONTENCODING_CP1257
: ret
= 1257; break;
1601 case wxFONTENCODING_EUC_JP
: ret
= 20932; break;
1603 case wxFONTENCODING_MACROMAN
: ret
= 10000; break;
1604 case wxFONTENCODING_MACJAPANESE
: ret
= 10001; break;
1605 case wxFONTENCODING_MACCHINESETRAD
: ret
= 10002; break;
1606 case wxFONTENCODING_MACKOREAN
: ret
= 10003; break;
1607 case wxFONTENCODING_MACARABIC
: ret
= 10004; break;
1608 case wxFONTENCODING_MACHEBREW
: ret
= 10005; break;
1609 case wxFONTENCODING_MACGREEK
: ret
= 10006; break;
1610 case wxFONTENCODING_MACCYRILLIC
: ret
= 10007; break;
1611 case wxFONTENCODING_MACTHAI
: ret
= 10021; break;
1612 case wxFONTENCODING_MACCHINESESIMP
: ret
= 10008; break;
1613 case wxFONTENCODING_MACCENTRALEUR
: ret
= 10029; break;
1614 case wxFONTENCODING_MACCROATIAN
: ret
= 10082; break;
1615 case wxFONTENCODING_MACICELANDIC
: ret
= 10079; break;
1616 case wxFONTENCODING_MACROMANIAN
: ret
= 10009; break;
1618 case wxFONTENCODING_ISO2022_JP
: ret
= 50222; break;
1620 case wxFONTENCODING_UTF7
: ret
= 65000; break;
1621 case wxFONTENCODING_UTF8
: ret
= 65001; break;
1626 if (::IsValidCodePage(ret
) == 0)
1630 if (::GetCPInfo(ret
, &info
) == 0)
1636 extern long wxCharsetToCodepage(const char *name
)
1638 // first get the font encoding for this charset
1642 wxFontEncoding enc
= wxFontMapperBase::Get()->CharsetToEncoding(name
, false);
1643 if ( enc
== wxFONTENCODING_SYSTEM
)
1646 // the use the helper function
1647 return wxEncodingToCodepage(enc
);
1650 #else // !wxUSE_FONTMAP
1652 #include "wx/msw/registry.h"
1654 // this should work if Internet Exploiter is installed
1655 extern long wxCharsetToCodepage(const char *name
)
1663 wxString
path(wxT("MIME\\Database\\Charset\\"));
1666 // follow the alias loop
1669 wxRegKey
key(wxRegKey::HKCR
, path
+ cn
);
1674 // two cases: either there's an AliasForCharset string,
1675 // or there are Codepage and InternetEncoding dwords.
1676 // The InternetEncoding gives us the actual encoding,
1677 // the Codepage just says which Windows character set to
1678 // use when displaying the data.
1679 if (key
.HasValue(wxT("InternetEncoding")) &&
1680 key
.QueryValue(wxT("InternetEncoding"), &CP
))
1683 // no encoding, see if it's an alias
1684 if (!key
.HasValue(wxT("AliasForCharset")) ||
1685 !key
.QueryValue(wxT("AliasForCharset"), cn
))
1688 #endif // wxUSE_REGKEY
1693 #endif // wxUSE_FONTMAP/!wxUSE_FONTMAP
1696 Creates a hidden window with supplied window proc registering the class for
1697 it if necesssary (i.e. the first time only). Caller is responsible for
1698 destroying the window and unregistering the class (note that this must be
1699 done because wxWidgets may be used as a DLL and so may be loaded/unloaded
1700 multiple times into/from the same process so we cna't rely on automatic
1701 Windows class unregistration).
1703 pclassname is a pointer to a caller stored classname, which must initially be
1704 NULL. classname is the desired wndclass classname. If function successfully
1705 registers the class, pclassname will be set to classname.
1707 extern "C" WXDLLIMPEXP_BASE HWND
1708 wxCreateHiddenWindow(LPCTSTR
*pclassname
, LPCTSTR classname
, WNDPROC wndproc
)
1710 wxCHECK_MSG( classname
&& pclassname
&& wndproc
, NULL
,
1711 wxT("NULL parameter in wxCreateHiddenWindow") );
1713 // register the class fi we need to first
1714 if ( *pclassname
== NULL
)
1717 wxZeroMemory(wndclass
);
1719 wndclass
.lpfnWndProc
= wndproc
;
1720 wndclass
.hInstance
= wxGetInstance();
1721 wndclass
.lpszClassName
= classname
;
1723 if ( !::RegisterClass(&wndclass
) )
1725 wxLogLastError(wxT("RegisterClass() in wxCreateHiddenWindow"));
1730 *pclassname
= classname
;
1733 // next create the window
1734 HWND hwnd
= ::CreateWindow
1748 wxLogLastError(wxT("CreateWindow() in wxCreateHiddenWindow"));