file_operations.hpp

新版本TR1的stl

 * \param progressTitle String to be displayed describing the operation
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_a_t const* from, ws_char_a_t const* progressTitle, ws_bool_t &bAborted)
{
    return shell_delete_a_(NULL, from, progressTitle, 0, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 * \param flags One or more of the FILEOP_FLAGS values.
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored. The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_a_t const* from, ws_char_a_t const* progressTitle, FILEOP_FLAGS flags)
{
    return shell_delete_a_(NULL, from, progressTitle, flags, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 * \param flags One or more of the FILEOP_FLAGS values.
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored. The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_a_t const* from, ws_char_a_t const* progressTitle, FILEOP_FLAGS flags, ws_bool_t &bAborted)
{
    return shell_delete_a_(NULL, from, progressTitle, flags, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from)
{
    return shell_delete_a_(hwnd, from, NULL, 0, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, ws_bool_t &bAborted)
{
    return shell_delete_a_(hwnd, from, NULL, 0, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param flags One or more of the FILEOP_FLAGS values.
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored.
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, FILEOP_FLAGS flags)
{
    return shell_delete_a_(hwnd, from, NULL, flags, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param flags One or more of the FILEOP_FLAGS values.
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored.
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, FILEOP_FLAGS flags, ws_bool_t &bAborted)
{
    return shell_delete_a_(hwnd, from, NULL, flags, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, ws_char_a_t const* progressTitle)
{
    return shell_delete_a_(hwnd, from, progressTitle, 0, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, ws_char_a_t const* progressTitle, ws_bool_t &bAborted)
{
    return shell_delete_a_(hwnd, from, progressTitle, 0, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 * \param flags One or more of the FILEOP_FLAGS values.
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored. The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, ws_char_a_t const* progressTitle, FILEOP_FLAGS flags)
{
    return shell_delete_a_(hwnd, from, progressTitle, flags, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param hwnd Handle to the window that will act as the parent to any dialogs displayed
 * \param from The file to delete
 * \param progressTitle String to be displayed describing the operation
 * \param flags One or more of the FILEOP_FLAGS values.
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored. The flag FOF_SIMPLEPROGRESS is automatically added if progressTitle is non-NULL
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(HWND hwnd, ws_char_a_t const* from, ws_char_a_t const* progressTitle, FILEOP_FLAGS flags, ws_bool_t &bAborted)
{
    return shell_delete_a_(hwnd, from, progressTitle, flags, &bAborted);
}



/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_w_t const* from)
{
    return shell_delete_w_(NULL, from, NULL, 0, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 * \param bAborted A Boolean that will indicate whether the operation was aborted
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_w_t const* from, ws_bool_t &bAborted)
{
    return shell_delete_w_(NULL, from, NULL, 0, &bAborted);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 * \param flags One or more of the FILEOP_FLAGS values.
 *
 * \note Throws std::bad_alloc on allocation failure on translators that support it
 *
 * \note The FOF_WANTMAPPINGHANDLE flag is always ignored.
 *
 * \return A status code indicating the success of the operation
 *
 * \retval 0 The operation completed successfully
 * \retval ERROR_NOT_ENOUGH_MEMORY This is returned only when compiling with translators that do not support throwing std::bad_alloc on memory allocation failure
 * \retval !0 Any other Win32 error code
 */
inline int shell_delete(ws_char_w_t const* from, FILEOP_FLAGS flags)
{
    return shell_delete_w_(NULL, from, NULL, flags, NULL);
}

/** \brief Requests the shell to delete the given file
 *
 * \ingroup group__library__windows_shell
 *
 * \param from The file to delete
 * \param flags One or more of the FILEOP_FLAGS values.
 * \param bAborted A Boolean that will indicate whether the operation was aborted