ACTU:AcquireIndependentServiceTokenV2

ACTU:AcquireIndependentServiceTokenV2

Request #

WordDescription
0
0x00200382Cmd0x0020Param14Xlat2
1u8, Account slot
2-10ASCII NULL-terminated client ID (max. 32 characters + NULL terminator)
11Cache duration in seconds
12bool, do parental controls check (unused)
13bool, mark this token as non-process specific
14u32, current (caller) title process ID
15Descriptor for copying 1 handle
16Completion event handle

Response #

WordDescription
0
0x00200040Cmd0x0020Param1Xlat0
1Result code

Description #

Requests a V2 independent service token using the given client ID.

Other than using the V2 API instead of the V1 API (i.e. /api/v2 instead of /api/v1), this command is identical to ACTU:AcquireIndependentServiceToken.

The validity duration specifies for how long the requested token will be cached locally. If a token with the same configuration was found in the cache, and this token was acquired within the past Cache duration seconds, this command will use the cached token instead of requesting a new one. It follows that specifying 0 as the cache duration will force the ACT module to always request a new token.

Setting mark this token as non-process specific to true causes the requested token to be accessible from any process. Otherwise, the requested token will only be accessible to the process that created it (via the process ID).

See Independent Service Tokens for details.