GetInfo

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

Syntax

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

Parameters

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
Result::IsSuccess 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 it is registered yet.
ResultIpcNotSessionInitialized The session has not been initialized. This result is returned if this function is called before the Initialize function. Always call the Initialize function first thing when you use the BOSS library.
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