Measurement Computing ADLIB WIN - Manual (Page 51)

Chapter 12 Logical Device String Names 11-5
11.4 AL_GetLdsString
Prototype C\C++
ERRNUM AL_GetLdsString(LHLD lhld, LPSTR lpstr, long lMaxLength);
Visual Basic for Windows
Function AL_GetLdsString(ByVal lhld As Long, ByVal lpstr As String,
ByVal lMaxLength As Long) As Long
LHLD lhld handle of the LDSD
LPSTR lpstrLds destination address
long lMaxLength the count in bytes to be copied
The AL_GetLdsString function copies lMaxLength bytes for the ADLIB LDSD string to the destination
string. If the size of the destination string length is less than the string to be copied, the resulting string will
be truncated and NULL padded.
Parameter Description
lhld Identifies the instance of the logical device subsystem.
lpstrLds
Points to the input destination string.
lMaxLength
Maximum length in bytes to be copied to the user string , including the NULL
termination character.
Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.
Related Functions:
AL_SetLdsString
Program References:
NONE
Supported Logical Device Subsystems:
All