Метод ISCard::Transaction

Статья
06/13/2023

[Метод Transaction доступен для использования в операционных системах, указанных в разделе Требования. Модули смарт-карт предоставляют аналогичные функции.]

Метод Transaction выполняет операцию записи и чтения для объекта команды smart карта (единица данных протокола приложения). Строка ответа из смарт-карта для командной строки, определенной в карта, отправленной смарт-карта, будет доступна после возврата этой функции.

Синтаксис

HRESULT Transaction(
  [in, out] LPSCARDCMD *ppCmd
);

Параметры

ppCmd [in, out]: Указатель на объект команды smart карта.

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

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

Код возврата	Описание
S_OK	Операция выполнена успешно.
E_INVALIDARG	Недопустимый параметр ppCmd .
E_POINTER	В ppCmd передан недопустимый указатель.
E_OUTOFMEMORY	Память для удовлетворения запроса недоступна.

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

Примеры

В следующем примере показано выполнение операции записи и чтения в объекте команды smart карта.

HRESULT    hr;

// pISCard is a pointer to an instance of ISCard.
// pISCardCmd is a pointer to an instance of ISCardCmd,
// and ISCardCmd::BuildCmd has already been called.
hr = pISCard->Transaction(&pISCardCmd);
if (FAILED(hr))
{
    printf("Failed ISCard::Transaction\n");
    // Take other error handling action as needed.
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов	Windows XP
Прекращение поддержки сервера	Windows Server 2003
Заголовок	Scardmgr.h
Библиотека типов	Scardmgr.tlb
DLL	Scardssp.dll
IID	IID_ISCard определяется как 1461AAC3-6810-11D0-918F-00AA00C18068

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

AttachByHandle
AttachByReader
Отсоединить
get_Atr
get_CardHandle
get_Context
get_Protocol
get_Status
ISCard
LocksCard
Повторно подключить
UnlocksCard

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