Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Composition Setup
 

Функция(метод) GrdFormatMessage преобразует код ошибки в текстовую строку, соответствующую данному коду.

Синтаксис 

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
int GRD_API GrdFormatMessage(	
  HANDLE hGrd,
  int nErrorCode,
  int nLanguage,
  char *szErrorMsg
  int nErrorMsgSize
  void *pReserved
);	
Expand
titleПараметры функции

hGrd

хэндл, через который будет выполнено преобразование. Если параметр не равен нулю, преобразуется результат функции GrdGetLastError для этого хэндла. Иначе, если этот параметр равен NULL, преобразуется код, указанный в параметре nErrorCode

nErrorCode

код ошибки, который требуется преобразовать. Если hGrd не равен NULL, параметр игнорируется

nLanguage

идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан

GrdLng_ENG

Язык сообщений английский

GrdLng_RUS

Язык сообщений русский

szErrorMsg

указатель на буфер, в который будет помещена форматированная, заканчивающаяся символом '/0', строка сообщения об ошибке. Память под буфер должна быть выделена до вызова GrdFormatMessage

nErrorMsgSize

максимальное количество символов, которое может содержаться в строке сообщения, считая '/0'в конце строки

pReserved

зарезервировано, параметр игнорируется

Expand
titleВозвращаемое значение функции

Cтандартный набор Набор ошибок Guardant API

Expand
titleОписание

Функция GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Она преобразует код ошибки nErrorCode или полученный из хэндла, указанного в параметре hGrd, в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре nLanguage.

Card
labelC#
Code Block
languagec#
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
titleПараметры метода

errorCode [in] 

Тип: GrdE

код ошибки, который требуется преобразовать.

language [in]

Тип: GrdLNG

идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан

grdHangle [in]

Тип:  Handle

хэндл, через который будет выполнено преобразование

Expand
titleВозвращаемое значение метода

Набор ошибок перечисления GrdEGuardant API

Expand
titleОписание

Метод GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Он преобразует результат метода GrdGetLastError для хэндла  grdHandle  в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре language. Если параметр grdHandle нулевой не задан, то в текстовую строку преобразуется код ошибки, указанный в параметре errorCode.

Card
labelJava
Code Block
languagejava
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
titleПараметры метода

errorCode [in] 

Тип: GrdE

код ошибки, который требуется преобразовать.

language [in]

Тип: GrdLNG

идентификатор языка. Код ошибки будет преобразован в текстовую строку на языке, идентификатор которого указан

grdHangle [in]

Тип:  Handle

хэндл, через который будет выполнено преобразование

Expand
titleВозвращаемое значение метода

Набор ошибок класса GrdEGuardant API

Expand
titleОписание

Метод GrdFormatMessage используется для удобства диагностики в пользовательских приложениях. Он преобразует результат метода GrdGetLastError для хэндла  grdHandle  в текстовую строку, содержащую диагностическое сообщение на языке, заданном в параметре language. Если параметр grdHandle нулевой не задан, то в текстовую строку преобразуется код ошибки, указанный в параметре errorCode.