API Guide
2-794 API Functions 601355 Rev A
- To determine where the error occurred, and what the
error was, the client queries the request’s error handle
(with VS_Error_GetFields) to retrieve the error
handle’s object code.
- If the object code value is VSE_NONE, the client must
query the global error code (VSG_Error) to
determine where the error occurred.
• VSE_ERR_BADHANDLE - Specified handle was not a
valid command handle.
• VSE_ERR_NULLHANDLE - Specified handle was a null
pointer.
- If the object code value is VSE_VOLSERV, the error
occurred in VolServ and the client uses
VST_ERROR_NUMCODE to identify the specific error.
- If the object code value is not VSE_VOLSERV and is
not VSE_NONE, the error occurred in the API and the
client uses VST_ERROR_CODE to identify the
specific error.
• VSE_ERR_BADFIELD - An invalid parameter was
specified.
• VSE_ERR_BADSIZE - Value passed for a string parameter
exceeds the maximum allowable length for that parameter.
• VSE_ERR_NOTINITIALIZED - The VolServ API is not
initialized.
• VSE_ERR_NULLSTRING - A null value was passed to a
string argument.
• VSE_ERR_SEND - The API software could not send the
command request to VolServ. This may be an RPC
communication error and can indicate VolServ is not
executing.