Функция GetOpenCardNameA (winscard.h)

  • Статья

Функция GetOpenCardName отображает диалоговое окно смарт-карта "Выбрать карта". Вызовите функцию SCardUIDlgSelectCard вместо GetOpenCardName. Функция GetOpenCardName поддерживается для обеспечения обратной совместимости с версией 1.0 базовых компонентов смарт-карт Майкрософт, но вызовы GetOpenCardName сопоставляются с SCardUIDlgSelectCard.

Синтаксис

LONG GetOpenCardNameA(
  [in] LPOPENCARDNAMEA unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OPENCARDNAME для диалогового окна "Выбор карта".

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

Функция возвращает различные значения в зависимости от того, является ли она успешной или неудачной.

Код возврата Описание
Успешно
 SCARD_S_SUCCESS.
Failure
 Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Комментарии

Примечание

Заголовок winscard.h определяет GetOpenCardName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winscard.h
Библиотека Scarddlg.lib
DLL Scarddlg.dll

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

OPENCARDNAME