Specifies the expected data type returned from a Windows Dynamic Link Library (DLL) routine.
Data type: CHARACTER
Access: Readable/Writable
Applies to: Call object handle
The RETURN-VALUE-DLL-TYPE attribute must be assigned before invoking the call object's INVOKE( ) method. After invocation, RETURN-VALUE contains an equivalent ABL data type which matches RETURN-VALUE-DLL-TYPE as shown in the following table.
| RETURN-VALUE-DLL-TYPE | RETURN-VALUE |
|---|---|
| BYTE | INTEGER |
| CHARACTER | CHARACTER |
| DOUBLE | DECIMAL |
| FLOAT | DECIMAL |
| INT64 | INT64 |
| LONG | INTEGER |
| MEMPTR | MEMPTR |
| SHORT | INTEGER |
| UNSIGNED-LONG | INT64 |
| UNSIGNED-SHORT | INTEGER |
For example, if a DLL function is expected to return a LONG value, then RETURN-VALUE-DLL-TYPE is set to "LONG" before executing the INVOKE( ) method. After the invocation, RETURN-VALUE-DATA-TYPE has a value of "INTEGER" and RETURN-VALUE contains an INTEGER value.
If RETURN-VALUE-DLL-TYPE is not set, the DLL routine's return value is ignored, and RETURN-VALUE is set to the Unknown value (?).