nn::dlp::CTR::ServerState Enumerated Type

Syntax

enum ServerState;

Value

Value Description
SERVER_STATE_INVALID The server is not initialized.
SERVER_STATE_INITIALIZED Initialization is complete.
SERVER_STATE_OPENED_SESSIONS Accepting session participation requests.
SERVER_STATE_DISTRIBUTING The state while in the process of distributing.
SERVER_STATE_COMPLETE_DISTRIBUTION The server has finished distributing a child program.
SERVER_STATE_REBOOTING_CLIENTS Server is rebooting clients. After confirming that all clients are disconnected, quit Download Play. If carrying out local communication after that, wait for client connections via UDS.
Note: Clients will not always necessarily reconnect.
SERVER_STATE_ERROR An error has occurred, and reinitialization must occur. There are two conditions under which the server enters this state: (1) the system enters sleep mode or the WiFi button is turned off between calls to the Initialize and Finalize functions, (2) after the start of a download session, the user removes the card, or a client that is not in the CLIENT_STATE_RECONNECTING_NETWORK state disconnects.
SERVER_STATE_PREPARING_FOR_SYSTEM_DISTRIBUTION This is only used internally by the SDK. Preparing for system distribution.
SERVER_STATE_DISTRIBUTING_SYSTEM This is only used internally by the SDK. Distributing system.
SERVER_STATE_WAITING_RECONNECT This is only used internally by the SDK. Waiting for clients who rebooted systems after system distribution to reconnect. Clients will not necessarily always reconnect.
SERVER_STATE_PREPARING_FOR_TITLE_DISTRIBUTION This is only used internally by the SDK. The server is preparing to distribute a child program.
SERVER_STATE_DISTRIBUTING_TITLE This is only used internally by the SDK. The server is distributing a child program.

Description

Server states.

Following a call to the StartDistribute function, the distribution process proceeds automatically and transitions to the SERVER_STATE_COMPLETE_DISTRIBUTION state after the distribution has been completed.
However, during that time the state may also transition to SERVER_STATE_ERROR due to any number of factors (communications error, Sleep Mode, wireless-disabled state, etc.). Use the GetState function or the GetEventDesc function to monitor the state.

Also, make sure that the user can cancel distribution while the server is in the SERVER_STATE_DISTRIBUTING state. This is because the DLP server will wait indefinitely for rebooted clients to reconnect after a system update. All clients, however, will not necessarily reconnect.

Revision History

2010/08/16
Initial version.

CONFIDENTIAL