Guardian Procedure Calls Reference Manual

PROCESSHANDLE_DECOMPOSE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The PROCESSHANDLE_DECOMPOSE_ procedure returns one or more parts of a process handle.
Syntax for C Programmers
#include <cextdecs(PROCESSHANDLE_DECOMPOSE_)>
short PROCESSHANDLE_DECOMPOSE_ ( short *processhandle
,[ short *cpu ]
,[ short *pin ]
,[ __int32_t *nodenumber ]
,[ char *nodename ]
,[ short maxlen ]
,[ short *nodename-length ]
,[ char *procname ]
,[ short maxlen ]
,[ short *procname-length ]
,[ long long *sequence-number ] );
The character-string parameters nodename and procname are each followed by a parameter
maxlen that specifies the maximum length in bytes of the character string and an additional
parameter that returns the actual length of the string. In each case, the character-string parameter
and the two parameters that follow it must either all be supplied or all be absent.
Syntax for TAL Programmers
error := PROCESSHANDLE_DECOMPOSE_ ( processhandle ! i
,[ cpu ] ! o
,[ pin ] ! o
,[ nodenumber ] ! o
,[ nodename:maxlen ] ! o:i
,[ nodename-length ] ! o
,[ procname:maxlen ] ! o:i
,[ procname-length ] ! o
,[ sequence-number ] ); ! o
Parameters
processhandle
input
INT .EXT:ref:10
is the process handle from which one or more parts is returned.
1136 Guardian Procedure Calls (P)