Функция(метод) GrdCodeInit инициализирует пароль перед проведением быстрого взаимообратного преобразования данных. Функция(или метод) GrdCodeInit были предназначены для работы с устаревшими ключами Guardant Stealth. Функция(или метод) реализованы исключительно в целях совместимости и использование их в современных приложениях не рекомендуется.

int GRD_API GrdCodeInit(	
  HANDLE hGrd,
  DWORD dwCnvType,
  DWORD dwAddr,
  void *pKeyBuf
);	

hGrd

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

dwCnvType

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

GrdAT_Algo0

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

GrdAT_AlgoASCII

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

GrdAT_AlgoFile

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

dwAddr

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

pKeyBuf

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

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

GrdE_AlgoNotFound

Алгоритм с указанным номером не существует

GrdE_CRCErrorFunc

Ошибка CRC при выполнении алгоритма. Обычно возникает, если длина преобразуемогопароля не совпадает с длиной ответа алгоритма

GrdE_GPis0

Счетчик алгоритма достиг нулевого значения. Результат этого алгоритма больше нельзя получить

GrdE_InvalidCnvType

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

 

Набор ошибок Guardant API

Функция GrdCodeInit выполняет подготовительные действия перед проведением быстрого взаимообратного преобразования данных. Этот способ преобразования удобно использовать для обработки больших объемов информации (килобайты и мегабайты).

Функция GrdCodeInit позволяет преобразовать пароль для его дальнейшего использования в функциях GrdEnCode и GrdDeCode. Адрес буфера, содержащего преобразуемый пароль, задает параметр pKeyBuf. Длина пароля фиксирована и должна составлять 32 байта. Для преобразования пароля должен использоваться специальный аппаратный алгоритм Stealth I типа Fast; его порядковый номер задается в параметре dwAddr. В случае успешного выполнения функции по адресу, заданному в pKeyBuf, будет помещен преобразованный пароль.

Переменная dwCnvType задает метод быстрого взаимообратного преобразования, который будет использоваться в операциях GrdEnCode и GrdDeCode.

public static GrdE GrdCodeInit(Handle grdHandle, GrdAT cnvType, uint addr, byte[] key)

grdHandle [in] 

Тип: Handle

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

cnvType [in]

Тип: GrdAT

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

addr [in] 

Тип: uint

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

key [in] 

Тип: byte [ ]

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

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

GrdE.AlgoNotFound

Алгоритм с указанным номером не существует

GrdE.CRCErrorFunc

Ошибка CRC при выполнении алгоритма. Обычно возникает, если длина преобразуемогопароля не совпадает с длиной ответа алгоритма

GrdE.GPis0

Счетчик алгоритма достиг нулевого значения. Результат этого алгоритма больше нельзя получить

GrdE.InvalidCnvType

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

 

Набор ошибок Guardant API

Метод GrdCodeInit выполняет подготовительные действия перед проведением быстрого взаимообратного преобразования данных. Этот способ преобразования удобно использовать для обработки больших объемов информации (килобайты и мегабайты).

Метод GrdCodeInit позволяет преобразовать пароль для его дальнейшего использования в функциях GrdEnCode и GrdDeCode. Адрес буфера, содержащего преобразуемый пароль, задает параметр key. Длина пароля фиксирована и должна составлять 32 байта. Для преобразования пароля должен использоваться специальный аппаратный алгоритм Stealth I типа Fast; его порядковый номер задается в параметре addr. В случае успешного выполнения метода по адресу, заданному в key, будет помещен преобразованный пароль.

Переменная cnvType задает метод быстрого взаимообратного преобразования, который будет использоваться в операциях GrdEnCode и GrdDeCode.

 public static GrdE GrdCodeInit(Handle grdHandle, int cnvType, int addr, byte[] key)

grdHandle [in] 

Тип: Handle

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

cnvType [in]

Тип: int

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

addr [in] 

Тип: int

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

key [in] 

Тип: byte [ ]

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

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

GrdE.AlgoNotFound

Алгоритм с указанным номером не существует

GrdE.CRCErrorFunc

Ошибка CRC при выполнении алгоритма. Обычно возникает, если длина преобразуемогопароля не совпадает с длиной ответа алгоритма

GrdE.GPis0

Счетчик алгоритма достиг нулевого значения. Результат этого алгоритма больше нельзя получить

GrdE.InvalidCnvType

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

 

Набор ошибок Guardant API

Метод GrdCodeInit выполняет подготовительные действия перед проведением быстрого взаимообратного преобразования данных. Этот способ преобразования удобно использовать для обработки больших объемов информации (килобайты и мегабайты).

Метод GrdCodeInit позволяет преобразовать пароль для его дальнейшего использования в функциях GrdEnCode и GrdDeCode. Адрес буфера, содержащего преобразуемый пароль, задает параметр key. Длина пароля фиксирована и должна составлять 32 байта. Для преобразования пароля должен использоваться специальный аппаратный алгоритм Stealth I типа Fast; его порядковый номер задается в параметре addr. В случае успешного выполнения метода по адресу, заданному в key, будет помещен преобразованный пароль.

Переменная cnvType задает метод быстрого взаимообратного преобразования, который будет использоваться в операциях GrdEnCode и GrdDeCode.