NI Switch Executive

Table of Contents

niSE_GetError

  • Updated2023-02-21
  • 1 minute(s) read

Queries for and returns the most recent error.

Function Prototype

Function niSE_GetError( sessionHandle As NISESession,
errorNumber As Long,
errorDescription As String,
errorDescriptionSize As Long) As NISEStatus

Parameters

Input

NameTypeDescription
sessionHandle NISESession The session referencing this NI Switch Executive virtual device session.

Input/Output

NameTypeDescription
errorDescriptionSize Long The errorDescriptionSize is a Long that is passed by reference into the function.

As an input, it is the size of the error description buffer being passed. If the error description is larger than the error description buffer being passed, only the portion of the error description that can fit in the error description buffer is copied into it.

On return from the function, errorDescriptionSize holds the size required to hold the entire error description.
Note  errorDescriptionSize may be larger than the buffer size as the function always returns the size needed to hold the entire buffer.


You can pass NULL for this parameter if you are not interested in the return value for errorDescriptionSize and errorDescription.

Output

NameTypeDescription
errorNumber Long The error code.
errorDescription String Description of the error.

To dynamically allocate space for the errorDescription buffer, call niSE_GetError twice. The first call should specify a errorDescriptionSize of 0 and then use the returned errorDescriptionSize to allocate the correct buffer size.

Log in to get a better experience