3.3. Error Conventions
Most of the functions in the API return a SQRESULT value; SQRESULT indicates if a function completed successfully or not. The macros SQ_SUCCEEDED() and SQ_FAILED() are used to test the result of a function.:
if(SQ_FAILED(sq_getstring(v,-1,&s)))
printf("getstring failed");