1/*---------------------------------------------------------------------------*
2 *  pLastError.h  *
3 *                                                                           *
4 *  Copyright 2007, 2008 Nuance Communciations, Inc.                               *
5 *                                                                           *
6 *  Licensed under the Apache License, Version 2.0 (the 'License');          *
7 *  you may not use this file except in compliance with the License.         *
8 *                                                                           *
9 *  You may obtain a copy of the License at                                  *
10 *      http://www.apache.org/licenses/LICENSE-2.0                           *
11 *                                                                           *
12 *  Unless required by applicable law or agreed to in writing, software      *
13 *  distributed under the License is distributed on an 'AS IS' BASIS,        *
14 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
15 *  See the License for the specific language governing permissions and      *
16 *  limitations under the License.                                           *
17 *                                                                           *
18 *---------------------------------------------------------------------------*/
19
20#ifndef __PLASTERROR_H
21#define __PLASTERROR_H
22
23#include "LCHAR.h"
24#include "PortPrefix.h"
25
26#define printGetLastError(text) \
27  printGetLastErrorInternal(text, __FILE__, __LINE__)
28
29/**
30 * Retrieves a verbose error message associated with the result of GetLastError() and outputs it
31 * using PLogError (if available) or alternatively to PSTDERR.
32 *
33 * @param prefix A message to prefix the error message with.
34 */
35PORTABLE_API void printGetLastErrorInternal(const LCHAR* text, char* file, int line);
36
37#endif /* __PLASTERROR_H */
38