Agilent 81250 String Interface Library
Programming Interfaces
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
25
GetErrStr_HP81200
C Syntax
int HP81200_CDECL GetErrStr_HP81200(int ErrCode,
char *ErrMessage,
int *BufferSize)
VB Syntax
VB_GETERRSTR_HP81200(ByVal ErrNum As Long,
ByRef ErrString As String,
ByRef BufferSize As Long) As Long
Description
Gets the error string if one of the calls returns a negative value (see
“Error Handling” on page 23
). This usually happens if the connection
to the server or the creation of a handle fails.
Parameters
ErrCode
Error code returned by one of the other functions.
ErrMessage
Buffer to receive a human-readable error string
describing the error represented by
ErrCode
.
BufferSize
Size of the buffer allocated to receive the error message
(
ErrMessage
). On return, the variable holds the actual number of valid
characters in the buffer.
N O T E
The parameter
Response
is a buffer area provided by the caller. The
caller is responsible for reserving enough memory to hold the
response.
To prevent buffer overruns,
BufferSize
defines the maximum number
of bytes that can be written. This variable is set upon return to reflect
the number of bytes actually written. If the response does not fit into
the buffer, an error is returned.
Disconnect_HP81200
C Syntax
int HP81200_CDECL Disconnect_HP81200()
VB Syntax
VB_DISCONNECT_HP81200() As Long
Description
Disconnects from the Agilent 81250 server. This must be the last call
when using the Agilent 81250 String Interface Library.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com