nn::dlp::CTR::Server::StartDistribute Member Function

Syntax

static nn::Result StartDistribute();

Parameters

None.

Return Values

The following Result values are returned as the result of the operation.

Value Description
Result::IsSuccess The session started successfully.
ResultInvalidState The state is invalid or there is no client that was AcceptClient. Use with the SERVER_STATE_OPENED_SESSIONS state (after OpenSessions was successful).
ResultWirelessOff Communications cannot occur in this state (sleep or the wireless switch is off).
ResultFailedToAccessMedia Cannot access the media. The card may have been removed.

Description

Begins download sessions.

After this API is called, no new client connections can be made. In addition, clients in the CLIENT_STATE_WAITING_ACCEPT state are disconnected when this function is called. The server not only distributes the child program but may also distribute the system required to boot the child program.
The server will continue to wait indefinitely for the clients that downloaded the system to reboot and reconnect. However, clients will not necessarily reconnect. (For example, it may be that the download was canceled on the client side, wireless was disabled, power was interrupted, or a weak signal prevents communicating with the parent.) For this reason you must make it possible for users to halt a data download session at any time.

Revision History

2010/08/16
Initial version.

CONFIDENTIAL