docs

Home

All functions

Legacy functions

Categories

vuShellOpenUrl()

Clarion prototype

Prototype: vuShellOpenUrl(*CSTRING Url, *CSTRING OutText, LONG OutTextLen), SIGNED, PROC, PASCAL, RAW, NAME(‘vuShellOpenUrl’)

Purpose

Attempts to launch a URL in the user’s default browser and writes diagnostic text to an output buffer.

Parameters

| Parameter | Type | Description | |—|—|—| | Url | *CSTRING | URL to open. | | OutText | *CSTRING | Output buffer for success/failure diagnostics. | | OutTextLen | LONG | Size of xOutText in bytes. |

Return value / error codes

| Value | Meaning | |—|—| | 1 | Launch request accepted. | | -8 | Launch failed (details written to output text and LastError). |

Example (Clarion)

rc      LONG
url     CSTRING(512)
outTxt  CSTRING(512)

url = 'https://login.microsoftonline.com/'
outTxt = ''
rc = vuShellOpenUrl(url, outTxt, SIZE(outTxt))

IF rc = 1
  MESSAGE('Browser launch requested. ' & outTxt)
ELSE
  MESSAGE('Launch failed. rc=' & rc & ' msg=' & outTxt)
END

Notes

• URL input is sanitized and capped before launch attempts.
• This helper is frequently used by OAuth login flows that need interactive browser verification.

Home

All functions

Legacy functions

Categories