MuldeR's Utilities for Qt
MUtilities
|
MUtils OS-specific functions namespace. More...
Namespaces | |
Version | |
OS version information namespace. | |
Typedefs | |
typedef QMap< QString, QString > | ArgumentMap |
typedef bool(* | progress_callback_t) (const double &progress, void *const userData) |
Enumerations | |
enum | known_folder_t { FOLDER_LOCALAPPDATA = 0, FOLDER_PROGRAMFILES = 2, FOLDER_SYSTEMFOLDER = 3, FOLDER_SYSTROOT_DIR = 4 } |
This enumeration specifies "known" folder identifiers. More... | |
enum | network_type_t { NETWORK_TYPE_ERR = 0, NETWORK_TYPE_NON = 1, NETWORK_TYPE_YES = 2 } |
This enumeration specifies network connection types. More... | |
enum | drive_type_t { DRIVE_TYPE_ERR = 0, DRIVE_TYPE_FDD = 1, DRIVE_TYPE_HDD = 2, DRIVE_TYPE_NET = 3, DRIVE_TYPE_OPT = 4, DRIVE_TYPE_RAM = 5 } |
This enumeration specifies drive types. More... | |
Functions | |
MUTILS_API void | system_message_nfo (const wchar_t *const title, const wchar_t *const text) |
MUTILS_API void | system_message_wrn (const wchar_t *const title, const wchar_t *const text) |
MUTILS_API void | system_message_err (const wchar_t *const title, const wchar_t *const text) |
MUTILS_API const QStringList | crack_command_line (const QString &command_line=QString()) |
MUTILS_API const ArgumentMap & | arguments (void) |
MUTILS_API bool | copy_file (const QString &sourcePath, const QString &outputPath, const bool &overwrite=true, const progress_callback_t callback=NULL, void *const userData=NULL) |
MUTILS_API bool | get_file_version (const QString fileName, quint16 *const major=NULL, quint16 *const minor=NULL, quint16 *const patch=NULL, quint16 *const build=NULL) |
MUTILS_API const Version::os_version_t & | os_version (void) |
MUTILS_API const char * | os_friendly_name (const MUtils::OS::Version::os_version_t &os_version) |
MUTILS_API const bool & | running_on_wine (void) |
MUTILS_API const QString & | known_folder (known_folder_t folder_id) |
MUTILS_API QDate | current_date (void) |
MUTILS_API quint64 | current_file_time (void) |
MUTILS_API bool | is_elevated (bool *bIsUacEnabled=NULL) |
MUTILS_API bool | user_is_admin (void) |
MUTILS_API int | network_status (void) |
Check the network status. More... | |
MUTILS_API bool | handle_os_message (const void *const message, long *result) |
MUTILS_API void | sleep_ms (const size_t &duration) |
Suspend calling thread. More... | |
MUTILS_API bool | is_executable_file (const QString &path) |
MUTILS_API bool | is_library_file (const QString &path) |
MUTILS_API bool | is_hibernation_supported (void) |
MUTILS_API bool | shutdown_computer (const QString &message, const unsigned long timeout, const bool forceShutdown, const bool hibernate) |
MUTILS_API bool | free_diskspace (const QString &path, quint64 &freeSpace) |
MUTILS_API drive_type_t | get_drive_type (const QString &path, bool *fast_seeking=NULL) |
Detect drive type. More... | |
MUTILS_API bool | shell_open (const QWidget *parent, const QString &url, const bool explore=false) |
MUTILS_API bool | shell_open (const QWidget *parent, const QString &url, const QString ¶meters, const QString &directory, const bool explore=false) |
MUTILS_API bool | open_media_file (const QString &mediaFilePath) |
MUTILS_API bool | change_process_priority (const int priority) |
MUTILS_API bool | change_process_priority (const QProcess *proc, const int priority) |
MUTILS_API quint32 | process_id (void) |
MUTILS_API quint32 | process_id (const QProcess *const proc) |
MUTILS_API quint32 | thread_id (void) |
MUTILS_API quint32 | thread_id (const QProcess *const proc) |
MUTILS_API bool | suspend_process (const QProcess *proc, const bool suspend) |
MUTILS_API bool | setup_timer_resolution (const quint32 &interval=1) |
MUTILS_API bool | reset_timer_resolution (const quint32 &interval=1) |
MUTILS_API bool | set_file_time (const QFile &file, const QDateTime &created=QDateTime(), const QDateTime &modified=QDateTime(), const QDateTime &accessed=QDateTime()) |
MUTILS_API bool | set_file_time (const QString &path, const QDateTime &created=QDateTime(), const QDateTime &modified=QDateTime(), const QDateTime &accessed=QDateTime()) |
MUTILS_API bool | check_key_state_esc (void) |
MUTILS_API void | shell_change_notification (void) |
MUTILS_API QString | get_file_path (const int &fd) |
MUTILS_API bool | wow64fsredir_disable (void *oldValue) |
MUTILS_API bool | wow64fsredir_revert (void *oldValue) |
MUTILS_API QString | get_envvar (const QString &name) |
MUTILS_API bool | set_envvar (const QString &name, const QString &value) |
MUTILS_API void | check_debugger (void) |
MUTILS_API void | fatal_exit (const wchar_t *const errorMessage) |
MUtils OS-specific functions namespace.
This enumeration specifies drive types.
MUTILS_API drive_type_t MUtils::OS::get_drive_type | ( | const QString & | path, |
bool * | fast_seeking = NULL |
||
) |
Detect drive type.
This function detetcs the type of the drive to which the given path is pointing.
path | The path to the drive whose type is to be detected. On the Windows platform, only the drive letter is relevant. |
fast_seeking | Pointer to a variable that will be set to TRUE, if the drive supports "fast" seeking (e.g. SSD or similar device), or to FALSE otherwise. This parameter is optional and may be NULL. |
OS::drive_type_t
value. In case of error, the value DRIVE_TYPE_ERR
will be returned. MUTILS_API int MUtils::OS::network_status | ( | void | ) |
Check the network status.
Checks whether the computer is currently connected to a network. Note that an existing network connection does not necessarily imply actual Internet access!
OS::network_type_t
value. MUTILS_API void MUtils::OS::sleep_ms | ( | const size_t & | duration | ) |
Suspend calling thread.
This function suspends the calling thread. The thread will give up its current time-slice and enter "sleeping" state. The thread will remain in "sleeping" for the specified duration. After the specified duration has elapsed, the thread will be resumed.
Note that it depends on the operating system's scheduling decisions, when the thread will actually be allowed to execute again! While the thread is still in "sleeping" state, it can not be selected for execution by the operating system's scheduler. Once the thread is no longer in "sleeping" state, i.e. the specified period has elapsed, the thread can be selected for execution by the operating system's scheduler again - but this does not need to happen immediately! The scheduler decides which thread is allowed to execute next, taking into consideration thread priorities.
duration | The amount of time that the thread will be suspended, in milliseconds. A value of 0 means that the thread will not actually enter "sleeping" state, but it will still give up its current time-slice! |