Sync SDL2 wiki -> header

[ci skip]
This commit is contained in:
SDL Wiki Bot
2025-10-24 17:35:46 +00:00
parent 3e1cebed3c
commit 1edb3283b0

View File

@@ -573,16 +573,20 @@ extern DECLSPEC const char * SDLCALL SDL_WinRTGetFSPathUTF8(SDL_WinRT_Path pathT
extern DECLSPEC SDL_WinRT_DeviceFamily SDLCALL SDL_WinRTGetDeviceFamily();
/**
* Get the protocol activation URI if the app was launched via protocol activation.
* Get the protocol activation URI if the app was launched via protocol
* activation.
*
* When a UWP/WinRT app is launched via a custom URI scheme (e.g., myapp://action?param=value),
* this function retrieves the full activation URI string.
*
* The URI is only available once per activation - after the first successful call,
* subsequent calls will return NULL. This ensures the URI is processed only once.
* When a UWP/WinRT app is launched via a custom URI scheme (e.g.,
* myapp://action?param=value), this function retrieves the full activation
* URI string.
*
* \returns the protocol activation URI as a UTF-8 string that must be freed with SDL_free(),
* or NULL if the app was not activated via protocol or the URI was already retrieved.
* The URI is only available once per activation - after the first successful
* call, subsequent calls will return NULL. This ensures the URI is processed
* only once.
*
* \returns the protocol activation URI as a UTF-8 string that must be freed
* with SDL_free(), or NULL if the app was not activated via protocol
* or the URI was already retrieved.
*
* \since This function is available since SDL 2.33.0.
*/