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 GrdTRU_DecryptQuestionEx( 
HANDLE  hGrd,
DWORD   dwAlgoNum_Decrypt,
DWORD   dwAlgoNum_Hash,
DWORD   dwLngQuestion,
void    *pQuestion,
DWORD   dwID,
DWORD   dwPublic,
DWORD   dwLngHash,
void    *pHash,
DWORD   dwMode,
DWORD   dwReserved,
void    *pReserved 
);	
Expand
titleПараметры функции

hGrd

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

dwAlgoNum_Decrypt

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

dwAlgoNum_Hash

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

dwLngQuestion

размер присланного удаленным пользователем параметра число-вопрос

pQuestion

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

dwID

ID ключа удаленного пользователя, для которого будет произведена операция

dwPublic

численное значение Public Code ключа удаленного пользователя, для которого будет произведена операция

dwLngHash

длина данных в буфере, содержащий MAC, вычисленный на ключе удаленного пользователя.

pHash

буфер, содержащий MAC, вычисленный на ключе удаленного пользователя. Длина буфера 8 байт

dwMode

константа определяющая режим работы:

GrdTRU_CryptMode_GSII64

шифрование на базе GSII64 ( 8 байт), хеш на базе GSII64 (8 байт)

GrdTRU_CryptMode_AES128SHA256

шифрование на базе AES128(16 байт), хеш на базе SHA256(32 байт)

dwReserved

не используется. Параметр должен быть равен 0.

pReserved

не используется. Параметр должен быть равен NULL.

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

pQuestion

после выполнения функции в этот буфер возвращается расшифрованное число-вопрос.

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

GrdE_SystemDataCorrupted

Системные данные TRU повреждены. (Секретный ключ удаленного программирования отсутствует)

GrdE_NoQuestion

Число-вопрос не было сгенерировано или было перегенерировано до записи числа ответа

GrdE_InvalidData

Неверный формат данных для удаленного программирования

GrdE_QuestionOK

Число-вопрос уже было сгенерировано, ключ ожидает данных для удаленного программирования

GrdE_UpdateNotComplete

Ошибка при записи данных удаленного программирования. Операция не была завершена

GrdE_InvalidHash

Неверное значение MAC (Message Authentication Code)

 

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

Card
labelC#
Code Block
languagec#
public static GrdE GrdTRU_DecryptQuestionEx(Handle grdHandle, GrdAlgNum algNumDecrypt, GrdAlgNum algNumHash, byte[] question,
	uint id, uint publicCode, byte[] hash, GrdTRU truMode)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

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

algNumDecrypt [in]

Тип: GrdAlgNum

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

algNumHash [in]

Тип: GrdAlgNum

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

question [in,out]

Тип: byte [ ]

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

id [in]

Тип: uint

ID ключа удаленного пользователя, для которого будет произведена операция.

publicCode [in]

Тип: uint

Численное значение PublicCode ключа удаленного пользователя, для которого будет произведена операция.

hash [in]

Тип: byte [ ]

Буфер, который содержит MAC, вычисленный на ключе удаленного пользователя. Длина буфера 8 байт

truMode [in]

Тип: GrdTRU

Константа, которая определяет режим работы.

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

 

Card
labelJava
Code Block
languagejava
public static GrdE GrdTRU_DecryptQuestionEx(Handle grdHandle, int algoNum_Decrypt, int algoNum_Hash, 
	byte[] question, int id, int publicCode, byte[] hash, GrdTRU truMode)
Expand
titleПараметры метода

grdHandle [in] 

Тип: Handle

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

algNum_Decrypt [in]

Тип: int

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

algNum_Hash [in]

Тип: int

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

question [in,out]

Тип: byte [ ]

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

id [in]

Тип: int

ID ключа удаленного пользователя, для которого будет произведена операция.

publicCode [in]

Тип: int

Численное значение PublicCode ключа удаленного пользователя, для которого будет произведена операция.

hash [in]

Тип: byte [ ]

Буфер, который содержит MAC, вычисленный на ключе удаленного пользователя. Длина буфера 8 байт

truMode [in]

Тип: GrdTRU

Константа, которая определяет режим работы.

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

 

...