wailsapp/wails · error

GdiplusStartup failed with status

Error message

GdiplusStartup failed with status 

What it means

Error "GdiplusStartup failed with status " thrown in wailsapp/wails.

Source

Thrown at v3/pkg/w32/gdiplus.go:175

	return hbitmap, nil
}

func GdipDisposeImage(image *uintptr) {
	procGdipDisposeImage.Call(uintptr(unsafe.Pointer(image)))
}

func GdiplusShutdown() {
	procGdiplusShutdown.Call(token)
}

func GdiplusStartup(input *GdiplusStartupInput, output *GdiplusStartupOutput) {
	ret, _, _ := procGdiplusStartup.Call(
		uintptr(unsafe.Pointer(&token)),
		uintptr(unsafe.Pointer(input)),
		uintptr(unsafe.Pointer(output)))

	if ret != Ok {
		panic("GdiplusStartup failed with status " + GetGpStatus(int32(ret)))
	}
}

View on GitHub (pinned to 0e754b1b40)

Solutions

1. Ensure GdiplusStartup is called before any other GDI+ function, with a properly initialized GdiplusStartupInput (GdiplusVersion set to 1).
2. Check the returned GpStatus: out-of-memory, wrong version, or an already-initialized GDI+ subsystem are the common causes; only call GdiplusStartup once per process.
3. Confirm gdiplus.dll is available on the system (it ships with Windows XP and later; a missing DLL means an unsupported OS configuration).

When it happens

Trigger: Occurs when GdiplusStartup returns a non-Ok status, e.g. the GDI+ DLL is unavailable, the version is unsupported, or startup input parameters are invalid.

Common situations: See trigger scenarios.

AI-assisted analysis of wailsapp/wails@0e754b1b40 (2026-08-15). Data as JSON: /api/errors/abe4fd923ec0f37b. Report an issue: GitHub.