Page tree
Skip to end of metadata
Go to start of metadata

Функция(метод) 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.

    • No labels