Difference between revisions of "ACTU:AcquireIndependentServiceToken"

From 3dbrew
Jump to navigation Jump to search
(Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0014|14|2}} {{IPC/RequestEntry|u8, Account slot}} {{IPC/RequestEntryRange|9|ASCII NULL-terminated client ID (max. 32 characters...")
 
 
Line 25: Line 25:
  
 
Setting <code>mark this token as non-process specific</code> to <code>true</code> 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).
 
Setting <code>mark this token as non-process specific</code> to <code>true</code> 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 [[ACT_Services#Independent_Service_Tokens|Independent Service Tokens]] for details.

Latest revision as of 20:13, 20 January 2025

Request[edit]

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

Response[edit]

Index Word Description
0
Header 0x00140040 Cmd 0x0014 Param 1 Xlat 0
1 Result code

Description[edit]

Requests an independent service token using the given client ID.

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.