$DLLMSG (DLL get message)
$DLLMSG acquires a message from the $DLLEXEC2 and $DLLLOAD embedded functions that executed immediately beforehand. To acquire a message from the $DLLMSG embedded function, set the message address in the aim_getmessage function contained in the DLL that is being called.
- Organization of this page
Syntax
variable-name=$DLLMSG(DLL-object)
Values
-
DLL-object
Specifies the variable name of the DLL object that was acquired by the $DLLLOAD embedded function.
DLL interface to be used
The following shows the format of the function called by the $DLLMSG embedded function:
int aim_getmessage(void* object //Return value of the aim_init function
,char** message //Reference pointer for the message
)
Status
The following table lists and describes the possible statuses:
|
Status |
Description |
|---|---|
|
NORMAL |
Normal end (when the function returns 0) |
|
NODATA |
Termination with warning (when the function returns 1) |
|
ERROR |
Abnormal termination (when the function returns a positive value) |
|
Script execution interrupted |
Indicates one of the following:
|
- #
-
Indicates that the variable name of the specified DLL object is not the DLL object acquired by the $DLLLOAD embedded function.
Example
See the example for $DLLEXEC2 (execute DLL).