Trusted
462
edits
Changes
ACTU:AcquireIndependentServiceToken (edit)
Revision as of 16:17, 20 January 2025
, Yesterday at 16:17Created 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..."
=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0014|14|2}}
{{IPC/RequestEntry|u8, Account slot}}
{{IPC/RequestEntryRange|9|ASCII NULL-terminated client ID (max. 32 characters + NULL terminator)}}
{{IPC/RequestEntry|Cache duration in seconds}}
{{IPC/RequestEntry|bool, do parental controls check (unused)}}
{{IPC/RequestEntry|bool, mark this token as non-process specific}}
{{IPC/RequestEntry|u32, current (caller) title process ID}}
{{IPC/CopyHandle|1}}
{{IPC/CopyHandleEntry|Completion event handle}}
{{IPC/RequestEnd}}
=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0014|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}
=Description=
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 <code>Cache duration</code> 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 <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).
{{IPC/Request}}
{{IPC/RequestHeader|0x0014|14|2}}
{{IPC/RequestEntry|u8, Account slot}}
{{IPC/RequestEntryRange|9|ASCII NULL-terminated client ID (max. 32 characters + NULL terminator)}}
{{IPC/RequestEntry|Cache duration in seconds}}
{{IPC/RequestEntry|bool, do parental controls check (unused)}}
{{IPC/RequestEntry|bool, mark this token as non-process specific}}
{{IPC/RequestEntry|u32, current (caller) title process ID}}
{{IPC/CopyHandle|1}}
{{IPC/CopyHandleEntry|Completion event handle}}
{{IPC/RequestEnd}}
=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0014|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}
=Description=
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 <code>Cache duration</code> 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 <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).