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

Функция GcaRead производит считывание данных из памяти ключа.

    int GcaRead(	
      HANDLE hGrd,
      DWORD	dwAddr,
      DWORD	dwLng,
      void *pData,
      void *pReserved
    );
     Параметры функции

    hGrd

    не используется

    dwAddr

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

    dwLng

    количество считываемых байтов

    pData

    адрес буфера для считанных данных

    pReserved

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

     Возвращаемое значение функции
     Описание

    Функция GcaRead позволяет считывать данные из областей памяти ключа, на которые не наложен запрет на чтение. Адрес первого считываемого байта задается параметром dwAddr, количество байт - параметром dwLng. Режим адресации - используется режим адресации SAM). Если функция выполнена успешно, по адресу, заданному параметром pData, будут помещены считанные из ключа данные.

    Память для буфера данных должна быть выделена до вызова GcaRead. В этом случае функция возвращает GrdE_OK. В случае если вы попытаетесь прочитать данные из области памяти, на которую наложен запрет на чтение, также будет возвращено GrdE_OK, однако ни один байт прочитан не будет.

     

     

    • No labels