GET_PLATFORM

Use

Identifies the operating system running on the client system.

Return Value

[Returning] platform TYPE I

ID specifying platform, i.e. operating system. In general, this ID does not identify the release of the operating system but only the type of operating system. The sole exception is or rather was Microsoft Windows in the Windows GUI where different IDs were returned for each Windows version. For all Windows versions newer than Windows XP, the ID for Windows XP will be returned in the Windows GUI. All other GUIs have always returned the constant for Windows XP for any Windows operating system type.

Possible values:

  • PLATFORM_UNKNOWN (-1)

    platform could not be determined

  • PLATFORM_WINDOWS95 (1)

    client is running on Windows 95 (Windows GUI only)

  • PLATFORM_WINDOWS98 (2)

    client OS is Windows 98 (Windows GUI only)

  • PLATFORM_NT351 (3)

    OS on client PC is Windows NT 3.51 (Windows GUI only)

  • PLATFORM_NT40 (4)

    platform is Windows NT 4.0 (Windows GUI only)

  • PLATFORM_NT50 (5)

    client is running on Windows 2000 (Windows GUI only)

  • PLATFORM_MAC (6)

    client OS is Mac OS prior to Mac OS 10

  • PLATFORM_OS2 (7)

    platform is OS/2

  • PLATFORM_LINUX (8)

    client OS is Linux

  • PLATFORM_HPUX (9)

    client is running on HP-UX

  • PLATFORM_TRU64 (10)

    client is running on HP Tru64 Unix

  • PLATFORM_AIX (11)

    OS on client machine is IBM AIX

  • PLATFORM_SOLARIS (12)

    platform is SUN Solaris

  • PLATFORM_MACOSX (13)

    client OS is Mac OS 10

  • PLATFORM_WINDOWSXP (14)

    OS on client is Windows XP newer for Windows GUI or any Windows version for Java and Web GUI

Exceptions

CNTL_ERROR

Thrown if a call to one of the necessary front end methods for determination of the operating system fails.

ERROR_NO_GUI

Currently not used.

NOT_SUPPORTED_BY_GUI

Raised if neither Windows nor Java nor Web GUI is being used.