PPCToolbox.h

Go to the documentation of this file.

 
#ifndef __PPCTOOLBOX__
#define __PPCTOOLBOX__
 
#ifndef __MACTYPES__
#include <MacTypes.h>
#endif
 
#ifndef __APPLETALK__
#include <AppleTalk.h>
#endif
 
#if PRAGMA_ONCE
#pragma once
#endif
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#if PRAGMA_IMPORT
#pragma import on
#endif
 
#if PRAGMA_STRUCT_ALIGN
#pragma options align = mac68k
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
#endif
 
  typedef UInt8 PPCServiceType;
  enum
  {
    ppcServiceRealTime = 1
  };
 
  typedef SInt16 PPCLocationKind;
  enum
  {
    ppcNoLocation = 0,  /* There is no PPCLocName */
    ppcNBPLocation = 1, /* Use AppleTalk NBP      */
    ppcNBPTypeLocation =
        2,                 /* Used for specifying a location name type during PPCOpen only */
    ppcXTIAddrLocation = 3 /* Use TCP/IP or DNS host name address */
  };
 
  typedef SInt16 PPCPortKinds;
  enum
  {
    ppcByCreatorAndType =
        1,          /* Port type is specified as colloquial Mac creator and type */
    ppcByString = 2 /* Port type is in pascal string format */
  };
 
  /* Values returned for request field in PPCInform call */
  typedef UInt8 PPCSessionOrigin;
  enum
  {
    ppcLocalOrigin = 1, /* session originated from this machine */
    ppcRemoteOrigin = 2 /* session originated from remote machine */
  };
 
  typedef short PPCPortRefNum;
  typedef long PPCSessRefNum;
 
  /*  The maximum allowed size of a fAddress in PPCXTIAddress */
  enum
  {
    kMaxPPCXTIAddress = 95
  };
 
  typedef SInt16 PPCXTIAddressType;
  enum
  {
    kINETAddrType = 2, /*    An IP address in binary form (type InetHost).*/
    kDNSAddrType = 42  /*    A DNS or dotted-decimal name string (no leading length
                          byte, no NULL termination byte)*/
  };
 
  struct PPCXTIAddress
  {
    PPCXTIAddressType fAddressType; /* A constant specifying what kind of network
                                       address this is */
    UInt8 fAddress[96];             /* The contents of the network address (variable length,
                                       NULL terminated). */
  };
  typedef struct PPCXTIAddress PPCXTIAddress;
  typedef PPCXTIAddress *PPCXTIAddressPtr;
 
  struct PPCAddrRec
  {
    UInt8 Reserved[3];     /* reserved - must be initialize to 0          */
    UInt8 xtiAddrLen;      /* size of the xtiAddr field             */
    PPCXTIAddress xtiAddr; /* the transport-independent network address   */
  };
  typedef struct PPCAddrRec PPCAddrRec;
  typedef PPCAddrRec *PPCAddrRecPtr;
 
  struct LocationNameRec
  {
    PPCLocationKind locationKindSelector; /* which variant */
    union
    {
      EntityName nbpEntity; /* NBP name entity                   */
      Str32 nbpType;        /* just the NBP type string, for PPCOpen  */
      PPCAddrRec xtiType;   /* an XTI-type network address record     */
    } u;
  };
  typedef struct LocationNameRec LocationNameRec;
  typedef LocationNameRec *LocationNamePtr;
 
  struct PPCPortRec
  {
    ScriptCode nameScript;         /* script of name */
    Str32Field name;               /* name of port as seen in browser */
    PPCPortKinds portKindSelector; /* which variant */
    union
    {
      Str32 portTypeStr; /* pascal type string */
      struct
      {
        OSType portCreator;
        OSType portType;
      } port;
    } u;
  };
  typedef struct PPCPortRec PPCPortRec;
  typedef PPCPortRec *PPCPortPtr;
  struct PortInfoRec
  {
    SInt8 filler1;
    Boolean authRequired;
    PPCPortRec name;
  };
  typedef struct PortInfoRec PortInfoRec;
  typedef PortInfoRec *PortInfoPtr;
  typedef PortInfoRec *PortInfoArrayPtr;
  typedef union PPCParamBlockRec PPCParamBlockRec;
  typedef PPCParamBlockRec *PPCParamBlockPtr;
  typedef CALLBACK_API(void, PPCCompProcPtr)(PPCParamBlockPtr pb);
  typedef STACK_UPP_TYPE(PPCCompProcPtr) PPCCompUPP;
#define PPCHeader                                             \
  Ptr qLink;                 /* PPC's Internal Use */         \
  unsigned short csCode;     /* Requested PPC command */      \
  unsigned short intUse;     /* Internal Use */               \
  Ptr intUsePtr;             /* Internal Use */               \
  PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */  \
  volatile OSErr ioResult;   /* 16 <-- Command Result Code */ \
  unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
 
  struct PPCOpenPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    PPCPortRefNum portRefNum;  /* 38 <--   Port Reference */
    long filler1;
    PPCServiceType serviceType;   /* 44 -->    Bit field describing the requested
                                     port service */
    UInt8 resFlag;                /* Must be set to 0 */
    PPCPortPtr portName;          /* 46 -->   PortName for PPC */
    LocationNamePtr locationName; /* 50 -->   If NBP Registration is required */
    Boolean networkVisible;       /* 54 -->   make this network visible on network */
    Boolean nbpRegistered;        /* 55 <--   The given location name was registered on
                                     the network */
  };
  typedef struct PPCOpenPBRec PPCOpenPBRec;
  typedef PPCOpenPBRec *PPCOpenPBPtr;
  struct PPCInformPBRec
  {
    Ptr qLink;                  /* PPC's Internal Use */
    unsigned short csCode;      /* Requested PPC command */
    unsigned short intUse;      /* Internal Use */
    Ptr intUsePtr;              /* Internal Use */
    PPCCompUPP ioCompletion;    /* 12 --> Completion Routine */
    volatile OSErr ioResult;    /* 16 <--     Command Result Code */
    unsigned long Reserved[5];  /* Reserved for PPC, Don't use */
    PPCPortRefNum portRefNum;   /* 38 -->   Port Identifier */
    PPCSessRefNum sessRefNum;   /* 40 <--   Session Reference */
    PPCServiceType serviceType; /* 44 <--   Status Flags for type of session,
                                   local, remote */
    Boolean
        autoAccept;               /* 45 -->   if true session will be accepted automatically */
    PPCPortPtr portName;          /* 46 -->   Buffer for Source PPCPortRec */
    LocationNamePtr locationName; /* 50 -->   Buffer for Source LocationNameRec */
    StringPtr
        userName;                 /* 54 -->   Buffer for Soure user's name trying to link. */
    unsigned long userData;       /* 58 <--   value included in PPCStart's userData */
    PPCSessionOrigin requestType; /* 62 <--   Local or Network */
    SInt8 filler;
  };
  typedef struct PPCInformPBRec PPCInformPBRec;
  typedef PPCInformPBRec *PPCInformPBPtr;
  struct PPCStartPBRec
  {
    Ptr qLink;                  /* PPC's Internal Use */
    unsigned short csCode;      /* Requested PPC command */
    unsigned short intUse;      /* Internal Use */
    Ptr intUsePtr;              /* Internal Use */
    PPCCompUPP ioCompletion;    /* 12 --> Completion Routine */
    volatile OSErr ioResult;    /* 16 <--     Command Result Code */
    unsigned long Reserved[5];  /* Reserved for PPC, Don't use */
    PPCPortRefNum portRefNum;   /* 38 -->   Port Identifier */
    PPCSessRefNum sessRefNum;   /* 40 <--   Session Reference */
    PPCServiceType serviceType; /* 44 <--   Actual service method (realTime) */
    UInt8 resFlag;              /* 45 -->   Must be set to 0  */
    PPCPortPtr portName;        /* 46 -->   Destination portName */
    LocationNamePtr
        locationName; /* 50 -->   NBP or NAS style service location name */
    unsigned long
        rejectInfo; /* 54 <--   reason for rejecting the session request */
    unsigned long
        userData; /* 58 -->   Copied to destination PPCInform parameter block */
    unsigned long
        userRefNum; /* 62 -->   userRefNum (obtained during login process)  */
  };
  typedef struct PPCStartPBRec PPCStartPBRec;
  typedef PPCStartPBRec *PPCStartPBPtr;
  struct PPCAcceptPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    PPCSessRefNum sessRefNum; /* 40 -->   Session Reference */
  };
  typedef struct PPCAcceptPBRec PPCAcceptPBRec;
  typedef PPCAcceptPBRec *PPCAcceptPBPtr;
  struct PPCRejectPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    PPCSessRefNum sessRefNum; /* 40 -->   Session Reference */
    short filler2;
    long filler3;
    long filler4;
    unsigned long
        rejectInfo; /* 54 -->   reason for rejecting the session request  */
  };
  typedef struct PPCRejectPBRec PPCRejectPBRec;
  typedef PPCRejectPBRec *PPCRejectPBPtr;
  struct PPCWritePBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    PPCSessRefNum sessRefNum; /* 40 -->   Session Reference */
    Size bufferLength;        /* 44 -->   Length of the message buffer */
    Size actualLength;        /* 48 <--   Actual Length Written */
    Ptr bufferPtr;            /* 52 -->   Pointer to message buffer */
    Boolean more;             /* 56 -->   if more data in this block will be written */
    SInt8 filler2;
    unsigned long
        userData;        /* 58 -->   Message block userData Uninterpreted by PPC */
    OSType blockCreator; /* 62 -->   Message block creator Uninterpreted by PPC */
    OSType blockType;    /* 66 -->   Message block type Uninterpreted by PPC */
  };
  typedef struct PPCWritePBRec PPCWritePBRec;
  typedef PPCWritePBRec *PPCWritePBPtr;
  struct PPCReadPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    PPCSessRefNum sessRefNum; /* 40 -->   Session Reference */
    Size bufferLength;        /* 44 -->   Length of the message buffer */
    Size actualLength;        /* 48 <--   Actual length read */
    Ptr bufferPtr;            /* 52 -->   Pointer to message buffer */
    Boolean more;             /* 56 <--   if true more data in this block to be read */
    SInt8 filler2;
    unsigned long
        userData;        /* 58 <--   Message block userData Uninterpreted by PPC */
    OSType blockCreator; /* 62 <--   Message block creator Uninterpreted by PPC */
    OSType blockType;    /* 66 <--   Message block type Uninterpreted by PPC */
  };
  typedef struct PPCReadPBRec PPCReadPBRec;
  typedef PPCReadPBRec *PPCReadPBPtr;
  struct PPCEndPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    PPCSessRefNum sessRefNum; /* 40 -->   Session Reference */
  };
  typedef struct PPCEndPBRec PPCEndPBRec;
  typedef PPCEndPBRec *PPCEndPBPtr;
  struct PPCClosePBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    PPCPortRefNum portRefNum;  /* 38 -->   Port Identifier */
  };
  typedef struct PPCClosePBRec PPCClosePBRec;
  typedef PPCClosePBRec *PPCClosePBPtr;
  struct IPCListPortsPBRec
  {
    Ptr qLink;                 /* PPC's Internal Use */
    unsigned short csCode;     /* Requested PPC command */
    unsigned short intUse;     /* Internal Use */
    Ptr intUsePtr;             /* Internal Use */
    PPCCompUPP ioCompletion;   /* 12 --> Completion Routine */
    volatile OSErr ioResult;   /* 16 <--     Command Result Code */
    unsigned long Reserved[5]; /* Reserved for PPC, Don't use */
    short filler1;
    unsigned short startIndex;   /* 40 -->   Start Index */
    unsigned short requestCount; /* 42 -->   Number of entries to be returned */
    unsigned short
        actualCount;              /* 44 <--   Actual Number of entries to be returned */
    PPCPortPtr portName;          /* 46 -->   PortName Match */
    LocationNamePtr locationName; /* 50 -->   NBP or NAS type name to locate the
                                     Port Location */
    PortInfoArrayPtr bufferPtr;   /* 54 -->   Pointer to a buffer
                                     requestCount*sizeof(PortInfo) bytes big */
  };
  typedef struct IPCListPortsPBRec IPCListPortsPBRec;
  typedef IPCListPortsPBRec *IPCListPortsPBPtr;
  union PPCParamBlockRec
  {
    PPCOpenPBRec openParam;
    PPCInformPBRec informParam;
    PPCStartPBRec startParam;
    PPCAcceptPBRec acceptParam;
    PPCRejectPBRec rejectParam;
    PPCWritePBRec writeParam;
    PPCReadPBRec readParam;
    PPCEndPBRec endParam;
    PPCClosePBRec closeParam;
    IPCListPortsPBRec listPortsParam;
  };
 
/*  PPC Calling Conventions  */
#if CALL_NOT_IN_CARBON
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCInit
#endif
  OSErr
  PPCInit(void);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCOpenSync(__A0)
#endif
  OSErr
  PPCOpenSync(PPCOpenPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCOpenAsync(__A0)
#endif
  OSErr
  PPCOpenAsync(PPCOpenPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCInformSync(__A0)
#endif
  OSErr
  PPCInformSync(PPCInformPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCInformAsync(__A0)
#endif
  OSErr
  PPCInformAsync(PPCInformPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCStartSync(__A0)
#endif
  OSErr
  PPCStartSync(PPCStartPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCStartAsync(__A0)
#endif
  OSErr
  PPCStartAsync(PPCStartPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCAcceptSync(__A0)
#endif
  OSErr
  PPCAcceptSync(PPCAcceptPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCAcceptAsync(__A0)
#endif
  OSErr
  PPCAcceptAsync(PPCAcceptPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCRejectSync(__A0)
#endif
  OSErr
  PPCRejectSync(PPCRejectPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCRejectAsync(__A0)
#endif
  OSErr
  PPCRejectAsync(PPCRejectPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCWriteSync(__A0)
#endif
  OSErr
  PPCWriteSync(PPCWritePBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCWriteAsync(__A0)
#endif
  OSErr
  PPCWriteAsync(PPCWritePBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCReadSync(__A0)
#endif
  OSErr
  PPCReadSync(PPCReadPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCReadAsync(__A0)
#endif
  OSErr
  PPCReadAsync(PPCReadPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCEndSync(__A0)
#endif
  OSErr
  PPCEndSync(PPCEndPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCEndAsync(__A0)
#endif
  OSErr
  PPCEndAsync(PPCEndPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCCloseSync(__A0)
#endif
  OSErr
  PPCCloseSync(PPCClosePBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 PPCCloseAsync(__A0)
#endif
  OSErr
  PPCCloseAsync(PPCClosePBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 IPCListPortsSync(__A0)
#endif
  OSErr
  IPCListPortsSync(IPCListPortsPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 IPCListPortsAsync(__A0)
#endif
  OSErr
  IPCListPortsAsync(IPCListPortsPBPtr pb);
 
#if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
#pragma parameter __D0 IPCKillListPorts(__A0)
#endif
  OSErr
  IPCKillListPorts(IPCListPortsPBPtr pb);
 
  OSErr
  DeleteUserIdentity(unsigned long userRef);
 
  OSErr
  GetDefaultUser(unsigned long *userRef, Str32 userName);
 
  OSErr
  StartSecureSession(PPCStartPBPtr pb, Str32 userName, Boolean useDefault,
                     Boolean allowGuest, Boolean *guestSelected,
                     ConstStr255Param prompt);
 
#endif /* CALL_NOT_IN_CARBON */
 
  typedef CALLBACK_API(Boolean, PPCFilterProcPtr)(LocationNamePtr name,
                                                  PortInfoPtr port);
  typedef STACK_UPP_TYPE(PPCFilterProcPtr) PPCFilterUPP;
#if CALL_NOT_IN_CARBON
  PPCCompUPP
  NewPPCCompUPP(PPCCompProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
  enum
  {
    uppPPCCompProcInfo = 0x000000C0
  }; /* pascal no_return_value Func(4_bytes) */
#ifdef __cplusplus
  inline PPCCompUPP NewPPCCompUPP(PPCCompProcPtr userRoutine)
  {
    return (PPCCompUPP)NewRoutineDescriptor(
        (ProcPtr)(userRoutine), uppPPCCompProcInfo, GetCurrentArchitecture());
  }
#else
#define NewPPCCompUPP(userRoutine)   \
  (PPCCompUPP) NewRoutineDescriptor( \
      (ProcPtr)(userRoutine), uppPPCCompProcInfo, GetCurrentArchitecture())
#endif
#endif
 
  PPCFilterUPP
  NewPPCFilterUPP(PPCFilterProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
  enum
  {
    uppPPCFilterProcInfo = 0x000003D0
  }; /* pascal 1_byte Func(4_bytes, 4_bytes) */
#ifdef __cplusplus
  inline PPCFilterUPP NewPPCFilterUPP(PPCFilterProcPtr userRoutine)
  {
    return (PPCFilterUPP)NewRoutineDescriptor(
        (ProcPtr)(userRoutine), uppPPCFilterProcInfo, GetCurrentArchitecture());
  }
#else
#define NewPPCFilterUPP(userRoutine)   \
  (PPCFilterUPP) NewRoutineDescriptor( \
      (ProcPtr)(userRoutine), uppPPCFilterProcInfo, GetCurrentArchitecture())
#endif
#endif
 
  void
  DisposePPCCompUPP(PPCCompUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
  inline void DisposePPCCompUPP(PPCCompUPP userUPP)
  {
    DisposeRoutineDescriptor((UniversalProcPtr)userUPP);
  }
#else
#define DisposePPCCompUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
 
  void
  DisposePPCFilterUPP(PPCFilterUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
  inline void DisposePPCFilterUPP(PPCFilterUPP userUPP)
  {
    DisposeRoutineDescriptor((UniversalProcPtr)userUPP);
  }
#else
#define DisposePPCFilterUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
 
  void
  InvokePPCCompUPP(PPCParamBlockPtr pb, PPCCompUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
  inline void InvokePPCCompUPP(PPCParamBlockPtr pb, PPCCompUPP userUPP)
  {
    CALL_ONE_PARAMETER_UPP(userUPP, uppPPCCompProcInfo, pb);
  }
#else
#define InvokePPCCompUPP(pb, userUPP) \
  CALL_ONE_PARAMETER_UPP((userUPP), uppPPCCompProcInfo, (pb))
#endif
#endif
 
  Boolean
  InvokePPCFilterUPP(LocationNamePtr name, PortInfoPtr port,
                     PPCFilterUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
  inline Boolean InvokePPCFilterUPP(LocationNamePtr name, PortInfoPtr port,
                                    PPCFilterUPP userUPP)
  {
    return (Boolean)CALL_TWO_PARAMETER_UPP(userUPP, uppPPCFilterProcInfo, name,
                                           port);
  }
#else
#define InvokePPCFilterUPP(name, port, userUPP) \
  (Boolean)                                     \
      CALL_TWO_PARAMETER_UPP((userUPP), uppPPCFilterProcInfo, (name), (port))
#endif
#endif
 
#endif /* CALL_NOT_IN_CARBON */
 
#if CALL_NOT_IN_CARBON || OLDROUTINENAMES
/* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
#define NewPPCCompProc(userRoutine) NewPPCCompUPP(userRoutine)
#define NewPPCFilterProc(userRoutine) NewPPCFilterUPP(userRoutine)
#define CallPPCCompProc(userRoutine, pb) InvokePPCCompUPP(pb, userRoutine)
#define CallPPCFilterProc(userRoutine, name, port) \
  InvokePPCFilterUPP(name, port, userRoutine)
#endif /* CALL_NOT_IN_CARBON */
 
#if CALL_NOT_IN_CARBON
  OSErr
  PPCBrowser(ConstStr255Param prompt, ConstStr255Param applListLabel,
             Boolean defaultSpecified, LocationNameRec *theLocation,
             PortInfoRec *thePortInfo, PPCFilterUPP portFilter,
             ConstStr32Param theLocNBPType);
 
#endif /* CALL_NOT_IN_CARBON */
 
#define PPCOpen(pb, async) ((async) ? PPCOpenAsync(pb) : PPCOpenSync(pb))
#define PPCInform(pb, async) ((async) ? PPCInformAsync(pb) : PPCInformSync(pb))
#define PPCStart(pb, async) ((async) ? PPCStartAsync(pb) : PPCStartSync(pb))
#define PPCAccept(pb, async) ((async) ? PPCAcceptAsync(pb) : PPCAcceptSync(pb))
#define PPCReject(pb, async) ((async) ? PPCRejectAsync(pb) : PPCRejectSync(pb))
#define PPCWrite(pb, async) ((async) ? PPCWriteAsync(pb) : PPCWriteSync(pb))
#define PPCRead(pb, async) ((async) ? PPCReadAsync(pb) : PPCReadSync(pb))
#define PPCEnd(pb, async) ((async) ? PPCEndAsync(pb) : PPCEndSync(pb))
#define PPCClose(pb, async) ((async) ? PPCCloseAsync(pb) : PPCCloseSync(pb))
#define IPCListPorts(pb, async) \
  ((async) ? IPCListPortsAsync(pb) : IPCListPortsSync(pb))
 
#if PRAGMA_STRUCT_ALIGN
#pragma options align = reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
#endif
 
#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif /* __PPCTOOLBOX__ */