The return type specifies the C data type of the value returned from the function. If a function does not return a value, specify the return type VOID. Valid return value types are listed in the table which follows.
Return Type | Description |
---|---|
VOID | The function does not return a value. |
CHAR | A single character (1 byte) is returned. |
BYTE | A 1 byte signed integer is returned from the DLL as a number. |
UBYTE | A 1 byte unsigned integer is returned from the DLL as a number. |
SHORT | A 2 byte signed integer is returned from the DLL as a number. |
USHORT | A 2 byte unsigned integer is returned from the DLL as a number. |
LONG | A 4 byte signed integer is returned from the DLL as a number. |
ULONG | A 4 byte unsigned integer. Not supported. |
FLOAT | A 4 byte floating point value is returned from the DLL as a number. |
DOUBLE | An 8 byte floating point value. Not supported. |
LPVOID | A function declared as returning an LPVOID value returns a pointer. (The type of data referenced by the pointer is not relevant.) To extract the data referenced by this pointer, use GetValue(). |
LPCHAR | The DLL returns a pointer to a null-terminated string (an array of characters ending with character 0). OpenInsight extracts the character data up to the null terminator. |
LPBYTE | The DLL returns a pointer to a 1 byte signed integer. OpenInsight extracts the data as a number. |
LPUBYTE | The DLL returns a pointer to a 1 byte unsigned integer. OpenInsight extracts the data as a number. |
LPSHORT | The DLL returns a pointer to a 2 byte signed integer. OpenInsight extracts the data as a number. |
LPUSHORT | The DLL returns a pointer to a 2 byte unsigned integer. OpenInsight extracts the data as a number. |
LPLONG | The DLL returns a pointer to a 4 byte signed integer. OpenInsight extracts the data as a number. |
LPULONG | Not supported. |
LPDOUBLE | The DLL returns a pointer to an 8 byte floating value. OpenInsight extracts the data as a number. |