1da2fcc5创建于 17 天前历史提交

Window Error Codes

NOTE

This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.

1300001 Repeated Operation

Error Message
Repeated operation.

Description
This error code is reported when a repeated operation is performed.

Possible Causes

The window has been created.
The window is in the current state.

Solution
Before creating a window, check whether the window has been created or is in the current state.

1300002 Abnormal Window State

Error Message
This window state is abnormal.

Description
This error code is reported when you operate a window in an abnormal state, for example, a window that is not created yet or has been destroyed.

Possible Causes
The window to operate is not created or has been destroyed.

Solution
Operate the window that exists.

1300003 Abnormal Window Manager Service

Error Message
This window manager service works abnormally.

Description
This error code is reported when the window manager service is abnormal.

Possible Causes
The internal services of the window are not started normally.

Solution
Try again later or restart the device.

1300004 Unauthorized Operation

Error Message
Unauthorized operation.

Description
This error code is reported when the API does not have the required permissions to operate an object.

Possible Causes

The window object of another process is operated.
The window type is not supported.

Solution

Ensure that you are interacting only with windows created within your own process. If you are referencing windows from other processes, remove those references or calls.
Ensure that the related operations are consistent with the supported window type.

1300005 Abnormal WindowStage

Error Message
This window stage is abnormal.

Description
This error code is reported when you operate a WindowStage in the abnormal state, for example, a WindowStage that has been destroyed.

Possible Causes
The WindowStage is not created or has been destroyed.

Solution
Before operating a WindowStage, check whether it exists.

1300006 Abnormal Window Context

Error Message
This window context is abnormal.

Description
This error code is reported when you operate a window context in the abnormal state, for example, a window context that has been destroyed.

Possible Causes
The window context has been destroyed when being operated.

Solution
Before operating the window context, check whether it exists.

1300007 Application Startup Failure by WindowExtensionAbility

Error Message
Failed to start the ability.

Description
This error code is reported when a WindowExtensionAbility fails to start an application.

Possible Causes
Incorrect parameters are passed into the API used by the WindowExtensionAbility to start the application.

Solution
Pass in the correct parameters.

1300008 Display Device Exception

Error Message
The display device is abnormal.

Description
This error code is reported when the display device is abnormal.

Possible Causes

The display device is not ready.
The display device is removed.
The display device is damaged.

Solution
Ensure that the display device is normal.

1300009 Invalid Parent Window

Error Message
The parent window is invalid.

Description
This error code is reported when the parent window is invalid.

Possible Causes

No parent window is bound.
The parent window bound is abnormal. For example, the parent window has been destroyed.

Solution

Ensure that the subwindow is bound to the parent window.
Ensure that the status of the parent window is normal.

1300010 Unsupported Operation in the Current Window Mode

Error Message
The operation in the current window status is invalid.

Description
This error code is reported when the operation is not supported in the current window mode.

Possible Causes

Perform the move operation in the full-screen or split-screen window.
Perform the resize operation in the full-screen or split-screen window.

Solution

Do not move the full-screen or split-screen window.
Do not resize the full-screen or split-screen window.

1300011 Failure in Destroying a PiP Window

Error Message
Failed to destroy the PiP window.

Description
This error code is reported when destroying a PiP window fails.

Possible Causes
The pointer to the PiP window is null.

Solution
No action is required.

1300012 Abnormal PiP Window Status

Error Message
The PiP window state is abnormal.

Description
This error code is reported when the PiP window status is abnormal.

Possible Causes
The PiP window status is abnormal.

Solution
No action is required.

1300013 Failure in Creating a PiP Window

Error Message
Failed to create the PiP window.

Description
This error code is reported when creating a PiP window fails.

Possible Causes

Incorrect parameters are passed in to create the PiP window.
Attempt to start PiP in a non-full-screen window.

Solution

Correct the input parameters.
Do not start PiP in a non-full-screen window.

1300014 PiP Internal Error

Error Message
PiP internal error.

Description
This error code is reported when an internal error occurs in PiP.

Possible Causes

The window on which the PiP feature depends is abnormal or empty.
The PiP controller is abnormal.

Solution
No action is required.

1300015 Repeated PiP Operations

Error Message
Repeated PiP operation.

Description
This error code is reported when a repeated PiP operation is performed.

Possible Causes
The PiP window has been started or closed.

Solution
Do not start or stop PiP repeatedly.

1300016 Parameter Verification Error

Error Message

Parameter validation error.

Description

This error code is reported when parameters are incorrect. For example, the parameter value exceeds the allowed range, the length of the string or array does not meet the requirements, or the parameter format is incorrect.

Possible Causes

The parameter value is out of range.
The parameter length exceeds the allowed limits.
The parameter format is incorrect.

Solution

Verify that the parameters adhere to the required standards.

1300018 API Call Timeout

Error Message

API call timed out.

Description

This error code is reported when the API call times out.

Possible Causes

The wait time for a synchronous API call exceeds the upper limit.

Solution

The solution will vary based on the specific context. Typical approaches are:

Retry the API call a limited number of times.
Implement fallback measures, such as using cached data or alternative logic.
Abort the current processing logic.

1300019 Floating Ball Parameter Verification Error

Error Message

Wrong parameters for operating the floating ball.

Description

Possible Causes

The parameter value is out of range.
The parameter length exceeds the allowed limits.
The parameter format is incorrect.
A mandatory parameter is not passed.

Solution

Ensure that the parameter value is within the allowed range.
Ensure that the parameter length is within the allowed limits.
Use the correct format for parameters.
Check whether any mandatory parameter is not passed.

For details about the floating ball parameters, see FloatingBallParams.

1300020 Failure in Creating a Floating Ball Window

Error Message

Failed to create the floating ball window.

Description

This error code is reported when creating a floating ball window fails.

Possible Causes

Incorrect parameters are passed in to start the floating ball.
Attempt to start the floating ball on an unsupported device.
Attempt to start the floating ball when the application is in the background.

Solution

Check the parameters before starting the floating ball.
Verify that the device supports the floating ball before starting it.
Ensure that the application is in the foreground before starting the floating ball.

1300021 Failure in Starting Multiple Floating Balls

Error Message

Failed to start multiple floating ball windows.

Description

This error code is reported when starting multiple floating balls fails.

Possible Causes

Multiple floating ball controllers are created for the same application.

Solution

An application should create only one floating ball controller to start the floating ball. You are advised to use a singleton pattern to hold the floating ball controller.

1300022 Repeated Floating Ball Operation

Error Message

Repeated floating ball operation.

Description

This error code is reported when a repeated operation is performed on the floating ball.

Possible Causes

Attempt to start the floating ball while it is already running.
Attempt to stop the floating ball after it has already stopped.
Attempt to register the floating ball callback multiple times.

Solution

Check whether the floating ball is already running before starting it.
Check whether the floating ball has already stopped before stopping it.
Ensure that the callback is not already registered before registering the floating ball callback.

1300023 Internal Error of the Floating Ball

Error Message

Floating ball internal error.

Description

This error code is reported when an internal error occurs in the floating ball.

Possible Causes

The window on which the floating ball depends is abnormal or empty.
The floating ball controller is abnormal or empty.

Solution

Check the window of the floating ball to ensure it is not empty.
Check the status of the floating ball controller to ensure it is not empty.

1300024 Abnormal Floating Ball Window State

Error Message

The floating ball window state is abnormal.

Description

This error code is reported when the floating ball window state is abnormal.

Possible Causes

The floating ball window may not have been created or may have been destroyed.

Solution

Check that the floating ball window has been created and is not destroyed.

1300025 Unsupported Operation in the Current Floating Ball State

Error Message

The floating ball state does not support this operation.

Description

This error code is reported when the operation is not supported in the current floating ball state.

Possible Causes

Attempt to update the floating ball when it is not active.
Attempt to query window information when the floating ball is not active.
Attempt to launch an application window when the floating ball is not active.
Attempt to start the floating ball before the stop process is complete.

Solution

Check whether the floating ball is active before updating it.
Check whether the floating ball is active before querying window information.
Check whether the floating ball is active before launching an application window.
Wait for the floating ball to stop completely before restarting it.

1300026 Failure in Launch an Application Window via a Floating Ball

Error Message

Failed to restore the main window.

Description

This error code is reported when launching an application window via the floating ball fails.

Possible Causes

Incorrect parameters are passed.
The application does not have the ohos.permission.AUTO_RESTORE_MAIN_WINDOW permission and the floating ball is not tapped before the application window is launched.
Attempt to launch a window that belongs to another application.

Solution

Check the parameters used to launch the application window.
To launch the application window without user interaction, apply for the ohos.permission.AUTO_RESTORE_MAIN_WINDOW permission. Otherwise, launch the application window after the floating ball is tapped.
Launch the window that belongs to the current application.

1300027 Cannot Change Template Type When Updating the Floating Ball

Error Message

When updating the floating ball, the template type cannot be changed.

Description

This error code is reported when changing the template type fails.

Possible Causes

The template type used during the update is inconsistent with the one used during creation.

Solution

Ensure that the template type used when updating the floating ball matches the one used when it was created.

1300028 Floating Ball Based on a Static Template Cannot Be Updated

Error Message

Updating static template-based floating balls is not supported.

Description

This error code is reported when users attempt to update a floating ball based on a static template.

Possible Causes

Updating floating balls based on static templates is not supported.

Solution

Delete any existing floating balls based on static templates and create new ones.

1300030 Repeated Operations on the Float View

Error Message

Repeated operations on the float view.

Description

This error code is reported when operations are repeated on the float view.

Possible Causes

The float view is being started or has been started, and is started again.
The float view is being stopped or has been stopped, and is stopped again.
The float view callback is registered repeatedly.

Solution

You are advised to use onStateChange to obtain the current status change. Before starting the float view, check whether the float view has been started.
You are advised to use onStateChange to obtain the current status change. Before stopping the float view, check whether the float view has been stopped.
Before registering the float view callback, ensure that the callback has not been registered.

1300031 Operation Not Supported in the Float View

Error Message

The floatView state does not support this operation.

Description

The float view does not support the operation.

Possible Causes

The float view has been started but has not been stopped, and an operation that requires the float view be in stopped state (such as binding or unbinding) is performed.
The float view has not been started, and an operation that requires the float view be in started state (such as stopping, restoring the main window, or obtaining window attributes) is performed.
The float view is in stopping state, and a startup operation is performed.

Solution

Before performing an operation, check the current status of the float view to ensure that it meets the state requirements of the API.
To stop the float view, ensure that the float view has been started.
Wait until the float view stops (confirmed through the status change callback) and then perform the follow-up procedure.

1300032 Failed to Restore the Main Window

Error Message

Failed to restore the main window.

Description

This error code is reported when the float view fails to start the main window of the application.

Possible Causes

The user has never clicked the float view.
The float view is not displayed in the foreground.
The main window is in the PAUSED lifecycle state.
The main window is in the multitasking screen.

Solution

Instruct the user to click the float view and then try to restore the main window.
Check whether the float view is displayed in the foreground.
Check the lifecycle state of the main window to avoid calling the restoration API when the main window is in the PAUSED state.
Ensure that the main window is not in the multitasking state and try to restore it again.

1300033 Failed to Start the Float View

Error Message

Failed to start float view.

Description

This error code is reported when the float view fails to be started.

Possible Causes

Multiple float views are started for the same application.
When the float view is started, the main window associated with the context is not displayed in the foreground.

Solution

Only one float view can be started for the same application. Do not start multiple float views at the same time.
Before starting the float view, ensure that the application window to which the context is passed is displayed in the foreground.

1300034 Operation of the Float View Conflicts with Those of Other Float Views

Error Message

This operation conflicts with other floating windows.

Description

This error code is reported when this operation conflicts with other float views.

Possible Causes

The floating ball window or PiP window has been started in the application.

Solution

Before starting the float view, stop the floating ball window and PiP window.

1001 Window Null Pointer Exception^(deprecated)

Error Message
A window null pointer occurs.

Description
This error code is reported when you operate a window pointed to by a null pointer.

Possible Causes
A null pointer is used.

Solution
Operate the window that exists.

1002 Invalid Window Type^(deprecated)

Error Message
This window type is invalid.

Description
This error code is reported when the window type is invalid.

Possible Causes
An invalid window type is used. For details about valid window types, see WindowType.

Solution
Use a window type supported.

1003 Invalid Window Parameter^(deprecated)

Error Message
This window parameter is invalid.

Description
This error code is reported when a window parameter is invalid.

Possible Causes
Invalid parameters are passed in.

Solution
Correct the parameters.

1004 Ability Service Exception^(deprecated)

Error Message
This system ability service works abnormally.

Description
This error code is reported when the ability service is abnormal.

Possible Causes
When the window is destroyed, the proxy fails to be initialized.

Solution
Restart the device and try again.

1005 IPC Failure^(deprecated)

Error Message
This window IPC failed.

Description
This error code is reported when IPC fails.

Possible Causes
The window parameters fail to be transferred.

Solution
Before operating a window, ensure that the client and server services in the window are normal.

1007 Application Startup Failure by WindowExtensionAbility^(deprecated)

Error Message
Failed to start the ability.

Description
This error code is reported when a WindowExtensionAbility fails to start an application.

Possible Causes
Incorrect parameters are passed into the API used by the WindowExtensionAbility to start the application.

Solution
Pass in the correct parameters.

Window Error Codes

1300001 Repeated Operation

1300002 Abnormal Window State

1300003 Abnormal Window Manager Service

1300004 Unauthorized Operation

1300005 Abnormal WindowStage

1300006 Abnormal Window Context

1300007 Application Startup Failure by WindowExtensionAbility

1300008 Display Device Exception

1300009 Invalid Parent Window

1300010 Unsupported Operation in the Current Window Mode

1300011 Failure in Destroying a PiP Window

1300012 Abnormal PiP Window Status

1300013 Failure in Creating a PiP Window

1300014 PiP Internal Error

1300015 Repeated PiP Operations

1300016 Parameter Verification Error

1300018 API Call Timeout

1300019 Floating Ball Parameter Verification Error

1300020 Failure in Creating a Floating Ball Window

1300021 Failure in Starting Multiple Floating Balls

1300022 Repeated Floating Ball Operation

1300023 Internal Error of the Floating Ball

1300024 Abnormal Floating Ball Window State

1300025 Unsupported Operation in the Current Floating Ball State

1300026 Failure in Launch an Application Window via a Floating Ball

1300027 Cannot Change Template Type When Updating the Floating Ball

1300028 Floating Ball Based on a Static Template Cannot Be Updated

1300030 Repeated Operations on the Float View

1300031 Operation Not Supported in the Float View

1300032 Failed to Restore the Main Window

1300033 Failed to Start the Float View

1300034 Operation of the Float View Conflicts with Those of Other Float Views

1001 Window Null Pointer Exception(deprecated)

1002 Invalid Window Type(deprecated)

1003 Invalid Window Parameter(deprecated)

1004 Ability Service Exception(deprecated)

1005 IPC Failure(deprecated)

1007 Application Startup Failure by WindowExtensionAbility(deprecated)

1001 Window Null Pointer Exception^(deprecated)

1002 Invalid Window Type^(deprecated)

1003 Invalid Window Parameter^(deprecated)

1004 Ability Service Exception^(deprecated)

1005 IPC Failure^(deprecated)

1007 Application Startup Failure by WindowExtensionAbility^(deprecated)