Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File14.8.5.16  XHNewCookie                                             TOS

 Name:         »XHNewCookie« - Install additional XHDI handler.

 Opcode:       9

 Syntax:       LONG XHNewCookie ( ULONG newcookie );

 Description:  XHNewCookie installs an additional XHDI handler. 
               Advantage: The XHDI cookie continues to point to the 
               same address. Those who want to support this function 
               must do the following:

                1.  If this is the first call of this kind: Proceed 
                    subsequently as if the XHDI cookie had already 
                    pointed to newcookie at the time of installation.
                2.  If not: Pass function on to 'next' handler.

               Those who would like to perform a multiple installation 
               should proceed as follows:

                1.  Test whether XHNewCookie leads to success.
                2.  Otherways displace the cookie `by hand'.

               Note: This function is optional and may return EINVFN.

 Return value: XHDI error-codes

 Group:        XHDI functions

 See Also:     Arbitration   _drvbits   Partition types 
               System variables   XHDI cookie   XHDI terminology