Guardian Procedure Calls Reference Manual

GETSYSTEMSERIALNUMBER Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Summary
The GETSYSTEMSERIALNUMBER procedure returns the system serial number of the caller's system
as an ASCII character string of numerals.
Syntax for C Programmers
#include <cextdecs(GETSYSTEMSERIALNUMBER)>
short GETSYSTEMSERIALNUMBER ( short *string-buffer
,short max-buffer-length
,short *string-length );
Syntax for TAL Programmers
error := GETSYSTEMSERIALNUMBER ( string-buffer ! o
,max-buffer-length ! i
,string-length ); ! o
Parameters
string-buffer
output
INT .EXT:ref:*
is the string array that contains the numerals of the system serial number on return.
max-buffer-length
input
INT:value
is the size of the string-array buffer string-buffer.
string-length
output
INT .EXT:ref:1
returns the number of numerals in the serial number that is returned in string-buffer.
Returned Value
INT
-1 if max-buffer-length is too small; otherwise, a file-system error code.
674 Guardian Procedure Calls (G)