Versions Compared

Key

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

...

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
int GRD_API GrdDeCode(	
  DWORD dwCnvType,
  void *pKeyBuf,
  void *pData,
  DWORD dwLng
);	
Expand
titleПараметры функции

dwCnvType

метод быстрого взаимообратного преобразования. Задается одним из флагов GrdAT_XXX. Должен быть эквивалентен методу, заданному функцией GrdCodeInit

GrdAT_Algo0

Базовый метод. Кодирование выполняется блоками по 32 байта. Этот метод лучше всего использовать для преобразования нестроковых данных. Важная особенность метода: если закодировать большой объем памяти (или файл) участками, то декодирование нужно будет обязательно делать точно теми же участками, или же размер участков должен быть кратен 32 байтам. Функции GrdEnCode и GrdDeCode не изменяют пароль.

GrdAT_AlgoASCII

Символьный метод. Кодирование выполняется блоками по 32 байта. Этот метод хорош для кодирования строковых данных. Например, если вы хотите закодировать название поля базы данных, указанное в исходном тексте программы, то в некоторых языках программирования будет проблематично создать строки с несимвольными значениями. Символьный метод кодирует строки так, чтобы в них не было неотображаемых символов. Функции GrdEnCode и GrdDeCode не изменяют пароль.

GrdAT_AlgoFile

Файловый метод. Кодирование выполняется блоками произвольной длины, поэтому такой метод подходит для кодирования файлов. Кодирование этим методом файла блоками меньше 32 байт неэффективно. Функции GrdEnCode и GrdDeCode в этом методе преобразования изменяют пароль, поэтому последовательность использования функции GrdDeCode должна совпадать с последовательностью использования функции GrdEnCode.

pKeyBuf

буфер, содержащий преобразованный пароль

pData

буфер с данными для раскодирования

dwLng

объем (в байтах) данных для раскодирования

wCnvType

метод быстрого взаимообратного преобразования (должен быть эквивалентен методу, заданному функцией GrdCodeInit

pKeyBuf

Адрес переменной, содержащей преобразованный пароль

pData

Адрес буфера с данными для декодирования

dwLng

Объем (в байтах) данных для декодирования

dwCnvType

Метод быстрого взаимообратного преобразования. Задается одним из флагов GrdAT_XXX

GrdAT_Algo0

Базовый метод. Кодирование выполняется блоками по 32 байта. Этот метод лучше всего использовать для преобразования нестроковых данных. Важная особенность метода: если закодировать большой объем памяти (или файл) участками, то декодирование нужно будет обязательно делать точно теми же участками, или же размер участков должен быть кратен 32 байтам. Функции GrdEnCode и GrdDeCode не изменяют пароль.

GrdAT_AlgoASCII

Символьный метод. Кодирование выполняется блоками по 32 байта. Этот метод хорош для кодирования строковых данных. Например, если вы хотите закодировать название поля базы данных, указанное в исходном тексте программы, то в некоторых языках программирования будет проблематично создать строки с несимвольными значениями. Символьный метод кодирует строки так, чтобы в них не было неотображаемых символов. Функции GrdEnCode и GrdDeCode не изменяют пароль.

GrdAT_AlgoFile

Файловый метод. Кодирование выполняется блоками произвольной длины, поэтому такой метод подходит для кодирования файлов. Кодирование этим методом файла блоками меньше 32 байт неэффективно. Функции GrdEnCode и GrdDeCode в этом методе преобразования изменяют пароль, поэтому последовательность использования функции GrdDeCode должна совпадать с последовательностью использования функции GrdEnCode.

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

Возможные ошибки

GrdE_InvalidCnvType

Указан неверный метод преобразования

 

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

Expand
titleОписание

Функция GrdDeCode позволяет раскодировать информацию, ранее закодированную функцией GrdEnCode, используя быстрое взаимообратное преобразование. При этом функция не обращается к ключу - преобразование полностью производится компьютером. За счет этого и достигается высокая скорость преобразования.

Параметр pKeyBuf содержит пароль, преобразованный ранее функцией GrdCodeInit. С его помощью и будет производиться раскодирование данных. Сами данные должны быть расположены по адресу, заданному параметром pData, длина раскодируемой последовательности (в байтах) задается параметром dwLng. Раскодирование производится по методу, указанному в параметре wCnvType. Выбирая тот или иной метод преобразования необходимо учитывать его особенности и ограничения. Метод кодирования должен соответствовать заданному при вызове функции GrdCodeInit.

При успешном завершении по адресу, указанному в pData, будут помещены раскодированные данные. В этом случае функция вернет GrdE_OK.

Card
labelC#
Code Block
languagec#
public static GrdE GrdDeCode(GrdAT cnvType, byte[] key, byte[] data)

Expand
titleПараметры метода

cnvType [in] 

Тип: GrdAT

Метод быстрого взаимнообратного преобразования. Задается одним из флагов GrdAT.

key [in] 

Тип: byte [ ]

Буфер, который содержит преобразованный пароль.

data [in]

Тип: byte [ ]

Буфер с данными для раскодирования.

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

Возможные ошибки

GrdE_InvalidCnvType

Указан неверный метод преобразования

 

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


Expand
titleОписание

Функция Метод GrdDeCode позволяет раскодировать информацию, ранее закодированную функцией GrdEnCode, используя быстрое взаимообратное преобразование. При этом функция метод не обращается к ключу - преобразование полностью производится компьютером. За счет этого и достигается высокая скорость преобразования.

Параметр pKeyBuf key содержит пароль, преобразованный ранее функцией методом GrdCodeInit. С его помощью и будет производиться раскодирование данных. Сами данные должны быть расположены по адресу, заданному параметром pData, длина раскодируемой последовательности (в байтах) задается параметром dwLng data. Раскодирование производится по методу, указанному в параметре wCnvType cnvType. Выбирая тот или иной метод преобразования необходимо учитывать его особенности и ограничения. Метод кодирования должен соответствовать заданному при вызове функции GrdCodeInit.

При успешном завершении по адресу, указанному в pData data, будут помещены раскодированные данные. В этом случае функция метод вернет GrdE_.OK.

Card
labelJava
Code Block
languagejava
public static GrdE GrdDeCode(int cnvType, byte[] key, byte[] data)
Expand
titleПараметры метода

cnvType [in] 

Тип: int

Метод быстрого взаимнообратного преобразования.

key [in] 

Тип: byte [ ]

Буфер, который содержит преобразованный пароль.

data [in]

Тип: byte [ ]

Буфер с данными для раскодирования.

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

Возможные ошибки

GrdE_InvalidCnvType

Указан неверный метод преобразования

 

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


Expand
titleОписание

Функция Метод GrdDeCode позволяет раскодировать информацию, ранее закодированную функцией GrdEnCode, используя быстрое взаимообратное преобразование. При этом функция метод не обращается к ключу - преобразование полностью производится компьютером. За счет этого и достигается высокая скорость преобразования.

Параметр pKeyBuf key содержит пароль, преобразованный ранее функцией методом GrdCodeInit. С его помощью и будет производиться раскодирование данных. Сами данные должны быть расположены по адресу, заданному параметром pData, длина раскодируемой последовательности (в байтах) задается параметром dwLng data. Раскодирование производится по методу, указанному в параметре wCnvType cnvType. Выбирая тот или иной метод преобразования необходимо учитывать его особенности и ограничения. Метод кодирования должен соответствовать заданному при вызове функции GrdCodeInit.

При успешном завершении по адресу, указанному в pData data, будут помещены раскодированные данные. В этом случае функция метод вернет GrdE_.OK.