MAC_TOKEN

Structure used to represent GroupWise tokens. It contains information identifying the token as well as token parameter data. When allocating memory for a MAC_TOKEN structure, memory for the first parameter is provided. If the token has more than one parameter, additional contiguous memory must be allocated for MAC_PARAM.

Definition

typedef struct _tagMAC_TOKEN 
{ 
   HSZ              hszCommand; 
   MAC_IPCVERSION   Version; 
   HSZ              hszRequestor; 
   MAC_MACROID      dwMacroID; 
   ATOM             atomApp; 
   WORD             wReserved; 
   MAC_TOKENID      wTokenId
   MAC_COUNT        cParam; 
   DWORD            dwFlags; 
   DWORD            dwReserved; 
   MAC_PARAM        rgParam[1]; 
} MAC_TOKEN, NEAR *NPMAC_TOKEN, FAR *LPMAC_TOKEN, *PMAC_TOKEN;

Types

The following types are used:

MAC_TOKEN	Structure used to represent actual tokens.
NPMAC_TOKEN	Near pointer to a MAC_TOKEN structure.
LPMAC_TOKEN	Far pointer to a MAC_TOKEN structure.
PMAC_TOKEN	Pointer to a MAC_TOKEN structure.

Members

The members are defined as follows:

hszCommand	Indicates where the token originated.
Version	Indicates the IPC version and must be set to 0 (==0).
hszRequestor	Unique application identifier.
dwMacroID	Application ID for this macro token. Should always be 0L.
atomApp	Where the token is bound.
wTokenId	Token ID
cParam	Number of token parameters.
dwFlags	Writeable or non-writeable.
dwReserved	Reserved.
rgParam	Parameter data block pointer. rgParam[0] contains the data for the first parameter. Make sure you allocate memory next to the first parameter for added parameters. See MAC_PARAM.