nn::boss::Task::GetInfo Member Function

Syntax

nn::Result GetInfo(
TaskPolicy * pPolicy,
TaskAction * pAction,
TaskOption * pOption,
u8 taskStep = CURRENT_STEP_ID
);

Arguments

Name Description
out pPolicy Specifies a task policy.
out pAction Specifies a task action.
out pOption Specifies task options.
in taskStep Specifies a task step ID. (Defaults to the current step if omitted)

Return Values

Returns the function's execution result. Returns one of the Result values listed below.
Value Description
ResultSuccess Retrieval successful.
ResultInvalidTaskId The task ID pointer is NULL or a zero-length string.
ResultInvalidPolicy The policy information pointer is NULL.
ResultInvalidAction The task action pointer is NULL.
ResultInvalidOption The task option pointer is NULL, or the option code is invalid.
ResultTaskNotExist The specified task ID was not found. Confirm whether registered.
ResultIpcNotSessionInitialized Either a session had not been initialized or there were incompatible permissions. This Result is returned if this function is called before either the Initialize or the InitializePriviledged function is called. When using the BOSS library, always begin by calling either the Initialize or the InitializePriviledged function.
A value other than the above. Unexpected error (see boss_Result.h for error details).

Description

Gets information about a registered task. You must prepare instances of the TaskPolicy, TaskAction, and TaskOption classes beforehand. See the GetProperty member function of each class for more information about obtaining the values of the attributes.

Revision History

2010/09/16
Initial version.

CONFIDENTIAL