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 GrdPI_Read(	
  HANDLE hGrd,
  DWORD dwItemNum,
  DWORD dwAddr,
  DWORD dwLng,
  void *pData,
  DWORD dwReadPsw,
  void *pReserved
);	
Expand
titleПараметры функции

hGrd

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

dwItemNum

номер защищенной ячейки/алгоритма из которой будет производиться чтение

dwAddr

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

dwLng

длина блока данных, которые должны быть прочитаны

pData

указатель на буфер для прочитанных данных

dwReadPsw

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

pReserved

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

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

pData

буфер, содержащий прочитанные данные

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

GrdE_AccessDenied

неверный пароль чтения, доступ к ячейке запрещен

GrdE_StatusUnchangeable

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

GrdE_NoService

для данного типа ячейки не предусмотрена операция чтения

GrdE_InactiveItem

ячейка в деактивированном состоянии, чтение выполнить невозможно

GrdE_Overbound

адрес для чтения выходит за пределы дескриптора

 

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

Card
labelC#
Code Block
languagec#
public static GrdE GrdPI_Read(Handle grdHandle,GrdAlgNum algNum, uint addr, byte[] data)
public static GrdE GrdPI_Read(Handle grdHandle,GrdAlgNum algNum, uint addr, byte[] data, uint readPsw)
public static GrdE GrdPI_Read(Handle grdHandle,GrdAlgNum algNum, uint addr, int lng, out byte[] data)
public static GrdE GrdPI_Read(Handle grdHandle,GrdAlgNum algNum, uint addr, int lng, out byte[] data, uint readPsw)

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

grdHandle [in] 

Тип: Handle

Нэндл, с помощью которого будет выполнено чтение.

algNum [in] 

Тип: GrdAlgNum

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

addr [in]

Тип: uint

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

data [out]

тип: byte [ ]

Указатель на буфер для прочитанных данных.

lng [in]

тип: int

Длина блока данных, которые должны быть прочитаны.

readPsw [in]

Тип: uint

Пароль для чтения.

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

 

Card
labelJava
Code Block
languagejava
public static GrdE GrdPI_Read(Handle grdHandle, int itemNum, int addr, byte[] data)
public static GrdE GrdPI_Read(Handle grdHandle, int itemNum, int addr, byte[] data, int readPsw)

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

 

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

 

...