# Common Program Exceptions | Snap Hutao
This document covers solutions of foreseeable client error RuntimeEnvironmentException Exception: RuntimeEnvironmentException; Hint: Unable to set registry key without enabling ...

Skip to main content

- Home
- Project
- Localization
- Quick Start

- Features

  - Home Dashboard
  - Game Launcher
  - Wish History
  - Achievement Management
  - Real-time Notes
  - My Characters
  - Hutao Database / Abyss Record
  - Development Plan
  - Character WIKI
  - Weapon WIKI
  - MiHoYo BBS Account Switch
  - Software Settings

- Advanced

  - FAQ
  - Common Program Exceptions
    - RuntimeEnvironmentException
    - Return Code: -10001
    - Return Code: 1034 Verification Failed
    - HttpRequestException Metadata Download Failed
      - 403 (Forbidden) / 404 (Not Found)
      - 502 (Bad Gateway)
  - Known Issue
  - 使用第三方工具获取有 Stoken 的 cookie
  - 祈愿系统与导出原理
  - Uninstall Snap Hutao

- Statements

  - Update Logs
  - Submit Bug Report
  - User Data and Privacy Notice
  - User Agreement and Legal Disclaime

# Common Program Exceptions

DGP-Studio
FAQ
About 1 min

On This Page

- RuntimeEnvironmentException
- Return Code: -10001
- Return Code: 1034 Verification Failed
- HttpRequestException Metadata Download Failed
- - 403 (Forbidden) / 404 (Not Found)
  - 502 (Bad Gateway)

# # Common Program Exceptions

This document covers solutions of foreseeable client error

## # RuntimeEnvironmentException

- Exception: `RuntimeEnvironmentException`
  - Hint: `Unable to set registry key without enabling long path`
- Issue source: Windows long path limit is set to be limited at 256 characters by default
- Solution: Download EnableLongPaths.zip
  open in new window, unzip it and run `.reg` file as administrator

## # Return Code: -10001

- This error comes directly from MiHoYo BBS, hints include
  - `Return Code: -10001`
  - `Return Code: -100`
- Issue source
  1. Cookie expired
  2. Network error
  3. System time is not accurate
- Solution
  1. In the account panel, execute `Refresh Cookies`
  2. Remove your account and add it again
  3. Sync your system time

## # Return Code: 1034 Verification Failed

- If Snap Hutao returns `1034` status code and hints verification failed (usually during the operation of Realtime Notes), it means the operation is blocked by MiHoYo BBS anti-bot system
- Solution:
  - Enter `Realtime Notes`
  - Click on `Verify Current User and Role` button
  - Follow the instruction in MiHoYo BBS to verify
  - After finishing the verification process, click `Complete` to close the verification window
  - Now, the account should back to normal; If not, process the step above again

Tips

If the risk prompt is too frequent, or the verification cannot be triggered at all, it means that the risk of your account is too high, please change the password, so that the simultaneous login status of multiple devices will be reset

Note

- You hardly cannot pass imperceptible verification when your account is login at other remote Genshin tools or login at multiple devices. This is a security designing of MiHoYo BBS, and cannot bypass
- If you are using multiple MiHoYo BBS account in your device, frequent usage with MiHoYo BBS API will result in your IP address being banned for a period of time (usually no more than 24 hours). This is a security designing of MiHoYo BBS, and cannot bypass

## # HttpRequestException Metadata Download Failed

### # 403 (Forbidden) / 404 (Not Found)

Solution: Update your Snap Hutao to latest version

### # 502 (Bad Gateway)

> Associated Issue: https://github.com/DGP-Studio/Snap.Hutao/issues/100
> open in new window

This HTTP Exception occurs when Snap Hutao failed to fetch remote resource (usually static image and configuration)

If you are using proxy software, you may need to turn it off or using TUN mode proxy; otherwise you need to use Windows 8 AppContainer Loopback Utility
open in new window to remove Windows APP Container Loopback limits
open in new window.

NickName(Optional)
E-Mail
Website(Optional)

#### Preview:

0 Words
Comments

- Latest
- Oldest
- Hottest

Powered by Waline v2.15.5