Функция(метод) GrdFormatMessage преобразует код ошибки в текстовую строку, соответствующую данному коду.
Синтаксис
Deck of Cards |
---|
|
Card |
---|
| Code Block |
---|
| int GRD_API GrdFormatMessage(
HANDLE hGrd,
int nErrorCode,
int nLanguage,
char *szErrorMsg
int nErrorMsgSize
void *pReserved
); |
Expand |
---|
| hGrd | хэндл, через который будет выполнено преобразование. Если параметр не равен нулю, преобразуется результат функции GrdGetLastError для этого хэндла. Иначе, если этот параметр равен NULL, преобразуется код, указанный в параметре nErrorCode | nErrorCode | код ошибки, который требуется преобразовать. Если hGrd не равен NULL, параметр игнорируется | nLanguage | идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан GrdLng_ENG | Язык сообщений английский | GrdLng_RUS | Язык сообщений русский |
| szErrorMsg | указатель на буфер, в который будет помещена форматированная, заканчивающаяся символом '/0', строка сообщения об ошибке. Память под буфер должна быть выделена до вызова GrdFormatMessage | nErrorMsgSize | максимальное количество символов, которое может содержаться в строке сообщения, считая '/0'в конце строки | pReserved | зарезервировано, параметр игнорируется |
|
|
Card |
---|
| Expand |
---|
title | Возвращаемые значения |
---|
| |
|
| Card |
---|
| Expand |
---|
title | Возвращаемые значения |
---|
| |
Expand |
---|
| Функция GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Она преобразует код ошибки nErrorCode или полученный из хэндла, указанного в параметре hGrd, в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре nLanguage. |
|
|
Wiki Markup |
---|
{dojo-tabs:theme=tundra|id=1}
{dojo-tab:title=C|selected=true}
*C*
int GRD_API GrdFormatMessage(
HANDLE hGrd,
int nErrorCode,
int nLanguage,
char *szErrorMsg
int nErrorMsgSize
void *pReserved
);
{dojo-tab}
{dojo-tab:title=C#|selected=true}
*C#*
{dojo-tab}
{dojo-tab:title=Visual Basic (Declaration)}
*Visual Basic*
{dojo-tab}
{dojo-tab:title=Visual C++}
*Visual C++*
{dojo-tab}
{dojo-tabs} |
Card |
---|
| Code Block |
---|
| public static GrdE GrdFormatMessage(GrdE errorCode, GrdLNG language, out string errorMsg)
public static GrdE GrdFormatMessage(Handle grdHandle, GrdE errorCode, GrdLNG language, out string errorMsg)
|
Expand |
---|
| errorCode [in] Тип: GrdE код ошибки, который требуется преобразовать. language [in] Тип: GrdLNG идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан grdHangle [in] Тип: Handle |
|
|
Expand |
---|
|
hGrdхэндл, через который будет выполнено преобразование |
| . Если параметр не равен нулю, преобразуется результат функции GrdGetLastError для этого хэндла. Иначе, если этот параметр равен NULL, преобразуется код, указанный в параметре nErrorCodenErrorCode Expand |
---|
| Метод GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Он преобразует результат метода GrdGetLastError для хэндла grdHandle в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре language. Если параметр grdHandle не задан, то в текстовую строку преобразуется код ошибки, указанный в параметре errorCode.
|
|
Card |
---|
| Code Block |
---|
| public static GrdE GrdFormatMessage(GrdE errorCode, GrdLNG language, java.lang.String[] outErrorMsg)
public static GrdE GrdFormatMessage(Handle grdHandle, GrdE errorCode, GrdLNG language, java.lang.String[] outErrorMsg) |
Expand |
---|
| errorCode [in] Тип: GrdE код ошибки, который требуется преобразовать. |
| Если hGrd не равен NULL, параметр игнорируетсяnLanguagelanguage [in] Тип: GrdLNG идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан |
|
GrdLng_ENG | Язык сообщений английский | GrdLng_RUS | Язык сообщений русский |
|
szErrorMsg | указатель на буфер, в который будет помещена форматированная, заканчивающаяся символом '/0', строка сообщения об ошибке. Память под буфер должна быть выделена до вызова GrdFormatMessage |
nErrorMsgSize | максимальное количество символов, которое может содержаться в строке сообщения, считая '/0'в конце строки |
pReserved | зарезервировано, параметр игнорируется |
Expand |
---|
|
grdHangle [in] Тип: Handle хэндл, через который будет выполнено преобразование |
| Cтандартный набор ошибокФункция Метод GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. |
| Она преобразует код ошибки nErrorCode или полученный из хэндла, указанного в параметре hGrd, в Он преобразует результат метода GrdGetLastError для хэндла grdHandle в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре |
| nLanguage. |
Expand |
---|
|
Пример для используемого средства разработки см. в директории:
"\%Program Files%\Guardant\Guardant 6\%PublicCode%\Samples\x86\Win32\General Guardant API\"
или
"\%Program Files%\Guardant\Guardant 6\%Public Code%\Samples\x64\Win64\General Guardant API\" language. Если параметр grdHandle не задан, то в текстовую строку преобразуется код ошибки, указанный в параметре errorCode. |
|
|