DosStartSession - Parameters

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: DosStartSession Return Value - ulrc]
[Next: DosStartSession - Remarks]