Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FilePgetuid()
Psetuid()                                                            GEMDOS

Syntax

WORD Psetuid( uid )
WORD uid;

Function      Psetuid() sets the user ID of the calling process.

Opcode        272 (0x110)

Availability  This function is available under all MiNT versions
              integrated with MultiTOS.

Parameters    uid is the user ID to assign to the calling process.

Binding       move.w   uid,-(sp)
              move.w   #$110,-(sp)
              trap     #1
              addq.l   #4,sp

Return Value  Psetuid() returns uid if successful or a negative GEMDOS
              error code otherwise.


Comments      As with the process group ID, the user ID of a process may
              only be set if it is currently 0. This means that once the
              user ID is set, it may not be changed.

See Also      Pgetuid()