a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 amigaguide.library
  --background--
  --rexxhost--
  AddAmigaGuideHostA
  AmigaGuideSignal
  CloseAmigaGuide
  GetAmigaGuideAttr
  GetAmigaGuideMsg
  GetAmigaGuideString
  LockAmigaGuideBase
  OpenAmigaGuideA
  OpenAmigaGuideAsyncA
  RemoveAmigaGuideHostA
  ReplyAmigaGuideMsg
  SendAmigaGuideCmdA
  SendAmigaGuideContextA
  SetAmigaGuideAttrsA
  SetAmigaGuideContextA
  UnlockAmigaGuideBase
Include
GuruMeditation
Docs » Autodocs » amigaguide.library » GetAmigaGuideMsg

NAME

        GetAmigaGuideMsg - Receive async AmigaGuide message.    (V34)

SYNOPSIS

        msg = GetAmigaGuideMsg (handle);
d0 a0
struct AmigaGuideMsg *GetAmigaGuideMsg (AMIGAGUIDECONTEXT);

FUNCTION

        This function returns a SIPC message from the AmigaGuide system,
if there is a message available.

INPUTS

        handle - Handle to a AmigaGuide system.

EXAMPLE

        AMIGAGUIDECONTEXT handle;
struct AmigaGuideMsg *agm;
/* get a AmigaGuide message */
while (agm = GetAmigaGuideMsg(handle))
{
/* process the event */
switch (agm->agm_Type)
{
case ToolCmdReplyID: /* a command has completed */
if (agm->agm_Pri_Ret)
{
/* An error occurred, the reason is in agm_Sec_Ret.
* The command string is in agm_Data
*/
}
break;
case ToolStatusID: /* status message */
if (agm->agm_Pri_Ret)
{
/* an error occurred, the reason is in agm_Sec_Ret */
}
break;
default:
break;
}
/* reply to the AmigaGuide message */
ReplyAmigaGuideMsg(agm);
}

RESULT

        msg -- Pointer to a SIPC message or NULL if no message was
available.

SEE ALSO

OpenAmigaGuideAsyncA(), AmigaGuideSignal(), ReplyAmigaGuideMsg()

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Defjam

ANA
PDX
DJ
FLT

Comments:

$VER: d0.se 1.14 Copyright © 2011-2020 Tobias Geijersson support at d0 dot se