Обработка кодов ошибок

До сих пор мы обрабатывали возвращаемые значения функций печати относительно просто: если функция печати (например, StartDoc) возвращает отрицательное значение, значит имеет место ошибка, и операция печати прерывается. Отрицательный код ошибки равен SP_ERROR (—1), и это единственное возвращаемое значение функций печати Win32, которое показывает наличие ошибки. Само по себе значение SP_ERROR о многом не говорит.

Более точно сообщить пользователю об ошибке можно с помощью функции GetLastError, вызывая ее сразу после ошибки. Если вызвать функцию GetLastError после того, как функция печати возвращает ошибку, то ее возвращаемым значением будет один из пяти возможных идентификаторов, которые определяются в файле WINGDI.H. Кроме них в файле WINGDI.H имеется идентификатор SP_NOTREPORTED, его значение равно 0х4000. Если результат поразрядной операции AND возвращаемого значения функции GetLastError и идентификатора SP_NOTREPORTED равен 0, то значит пользователь уже получил сообщение об ошибке. Результат поразрядной операции OR возвращаемого значения функции GetLastError и идентификатора SP_NOTREPORTED можно сравнить с пятью идентификаторами кодов ошибки для определения того, было ли уже выведено сообщение об ошибке или нет.

Следующий фрагмент программы показывает один из методов получения строки текста, идентифицирующей ошибку. Предполагается, что если возвращаемое значение функции печати отрицательно, то флаг bError устанавливается в TRUE. В представленном фрагменте этот флаг проверяется и, если имела место ошибка, вызывается функция _GetErrorText. Затем пользователю выводится окно сообщения об ошибке. Если пользователь к этому времени уже получил сообщение об ошибке, то возвращаемым значением функции _GetErrorText является NULL:

if (bError == TRUE)

{

pszErrMsg = _GetErrorText () ;

if (pszErrMsg)

MessageBox (hwnd, pszErrMsg, NULL, MB_OK) ;

}

.

.

LPCTSTR _GetErrorText (void)

{

static LPCTSTR pszErrorText [] = { "General error",

"Canceled from program",

"Canceled by user",

"Out of disk space",

"Out of memory" } ;

DWORD dwError = GetLastError () ;

if ((dwError & SP_NOTREPORTED) == 0)

return NULL ;

return pszErrorText [~dwError] ;

}

Далее приведены пять кодов ошибок с описанием возможных причин:

• SP_ERROR (0xFFFF или —1) — определяется как "general error" (общая ошибка). Это единственный код ошибки, являющийся возвращаемым значением функций печати в Win32. Он показывает, что модуль GDI или драйвер принтера не могут начать печать документа.

• SP_APPABORT (0xFFFE или —2) — этот код, как определено в документации, показывает, что процедура прерывания программы возвратила значение FALSE. Однако, это работает только при отключенном спулере. Если спулер работает, и если процедуре прерывания передается параметр iCode равный 0, а она возвращает значение FALSE, то возвращаемое значение функции EndPage будет положительно.

• SP_USERABORT (0xFFFD или —3) — этот код показывает, что пользователь отказался от задания на печать из окна папки Printers.

• SP_OUTOFDISK (0xFFFC или —4) — этот код показывает отсутствие свободного дискового пространства. Такой код ошибки появляется в том случае, если жесткий диск, на котором находится подкаталог TEMP, не может вместить ни одного временного файла спулера. Если в подкаталоге TEMP уже имеется несколько временных файлов спулера, тогда во время вызова функции EndPage вызывается процедура прерывания с параметром iCode равным SP_OUTOFDISK. Если после этого возвращаемым значением процедуры прерывания является FALSE, то возвращаемым значением функции EndPage становится SP_ERROR. Очередной вызов функции GetLastError возвратит ошибку SP_OUTOFDISK.

• SP_OUTOFMEMORY (0xFFFB или —5) — этот код показывает нехватку памяти для печати.