psd (PSTARTDATA) - input

      A pointer to the STARTDATA structure containing data needed to start a window session.

    pidSession (PULONG) - output

      A pointer to a ULONG in which the session identifier associated with the child session created is returned.

      pidSession is returned only when the value specified for Related is 1 (SSF_RELATED_CHILD). The pidSession returned can be specified on subsequent calls to DosSelectSession, DosSetSession, and DosStopSession.

      This parameter is not returned for independent sessions. For more information about independent sessions, refer to the Related field in the STARTDATA.

    ppid (PPID) - output

      A pointer to the PID in which the process identifier associated with the child process created is returned.

      ppid is returned only when the value specified for Related is 1 (SSF_RELATED_CHILD). The ppid returned may not be used on any system functions (for example, DosSetPriority) that require a parent process/child process relationship.

      This parameter is not returned for independent sessions. For more information about independent sessions, refer to the Related field in the STARTDATA structure.

      Refer to "Parent/Child Relationship" in the Remarks section for more information about child processes.

    ulrc (APIRET) - returns

      Return code.

      DosStartSession returns one of the following values:

    • NO_ERROR 369
        ERROR_SMG_INVALID_SESSION_ID
      418
        ERROR_SMG_INVALID_CALL
      457
        ERROR_SMG_START_IN_BACKGROUND
      460
        ERROR_SMG_PROCESS_NOT_PARENT
      463
        ERROR_SMG_RETRY_SUB_ALLOC
      For a full list of error codes, see Errors.

    [Back] [Next]