hab (HAB) - input

      Anchor-block handle.

    pswctlSwitchData (PSWCNTRL) - input

      Switch data.

      Contains information about the newly created Window List entry.

      If the field of the SWCNTRL structure is NULL, the system uses the name under which the application is started. This only applies for OS/2 programs, and only for the first call to this function since the program started. Otherwise, a NULL entry name is invalid.

      Leading and trailing blanks are removed from the title, which, if necessary, is also truncated to 60 characters.

      If the field of the SWCNTRL structure is NULLHANDLE, the value used by the system when the program was loaded (if it has been loaded) is substituted.

      If the field of the SWCNTRL structure is 0, the current process ID is used.

      If the field of the SWCNTRL structure is 0, the current session ID is used.

    hswitchSwitch (HSWITCH) - returns

      Handle to the newly created Window List entry.

      There is a system limit to the number of Window List entries. However, this is a large number (several hundred) and is unlikely to be reached in practice since other system limits, such as memory size, are likely to be reached first.

      NULLHANDLE

        Error occurred
      Other
        Handle to the newly created Window List entry.


      [Back] [Next]