Поделиться через

Метод ISCardISO7816::AppendRecord

  • Статья

[Метод AppendRecord доступен для использования в операционных системах, указанных в разделе Требования. Он недоступен для использования в Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях, Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Модули смарт-карт предоставляют аналогичные функции.]

Метод AppendRecord создает команду application protocol data unit (APDU), которая добавляет запись в конец линейно структурированного элементарного файла (EF) или записывает номер записи 1 в циклически структурированный элементарный файл.

Синтаксис

HRESULT AppendRecord(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Параметры

byRefCtrl [in]

Идентифицирует добавляемый элементарный файл.

Значение Значение
Текущий EF
 Битовое положение: 00000000
Короткий идентификатор EF
 Битовое положение: xxxxx000
Reserved
 Битовое положение: xxxxxxxx

 

pData [in]

Указатель на данные, добавляемые в файл.

Значение Значение
Tn
 1 байт
Ln
1 или 3 байта
data
 Ln байтов

 

ppCmd [in, out]

На входных данных — указатель на объект интерфейса ISCardCmd или NULL.

При возврате он заполняется командой APDU, созданной этой операцией. Если параметру ppCmd присвоено значение NULL, интеллектуальный объект картаISCardCmd создается и возвращается с помощью указателя ppCmd.

Возвращаемое значение

Метод возвращает одно из следующих возможных значений.

Код возврата Описание
S_OK
 Operation completed successfully (Операция выполнена успешно).
E_INVALIDARG
 Недопустимый параметр.
E_POINTER
 Был передан плохой указатель.
E_OUTOFMEMORY
 Недостаточно памяти.

 

Комментарии

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

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

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

Список всех методов, предоставляемых этим интерфейсом, см. в разделе ISCardISO7816.

В дополнение к приведенным выше кодам com-ошибок этот интерфейс может возвращать код ошибки смарт-карта, если для выполнения запроса была вызвана функция смарт-карта. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Прекращение поддержки сервера
 Windows Server 2003
Заголовок
Scardssp.h
Библиотека типов
Scardsrv.tlb
DLL
Scardssp.dll
IID
 IID_ISCardISO7816 определяется как 53B6AA68-3F56-11D0-916B-00AA00C18068

См. также раздел

ISCardISO7816

ReadRecord

UpdateRecord

WriteRecord