{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} | Входные параметры | hGrd | хэндл, через который будет выполнено преобразование. Если параметр не равен нулю, преобразуется результат функции GrdGetLastError для этого хэндла. Иначе, если этот параметр равен NULL, преобразуется код, указанный в параметре nErrorCode | nErrorCode | код ошибки, который требуется преобразовать. Если hGrd не равен NULL, параметр игнорируется | nLanguage | идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан GrdLng_ENG | Язык сообщений английский | GrdLng_RUS | Язык сообщений русский |
| szErrorMsg | указатель на буфер, в который будет помещена форматированная, заканчивающаяся символом '/0', строка сообщения об ошибке. Память под буфер должна быть выделена до вызова GrdFormatMessage | nErrorMsgSize | максимальное количество символов, которое может содержаться в строке сообщения, считая '/0'в конце строки | pReserved | зарезервировано, параметр игнорируется |
|
|
| Выходные параметры | Cтандартный набор ошибок| Expand |
|---|
| Функция GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Она преобразует код ошибки nErrorCode или полученный из хэндла, указанного в параметре hGrd, в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре nLanguage. |
|
| 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 хэндл, через который будет выполнено преобразование |
|
| Пример | Пример для используемого средства разработки см. в директории:
"\%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\" | Метод 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 код ошибки, который требуется преобразовать. language [in] Тип: GrdLNG идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан grdHangle [in] Тип: Handle хэндл, через который будет выполнено преобразование |
| Expand |
|---|
| Метод GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Он преобразует результат метода GrdGetLastError для хэндла grdHandle в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре language. Если параметр grdHandle не задан, то в текстовую строку преобразуется код ошибки, указанный в параметре errorCode. |
|
|
