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

Метод ISCardFileAccess::GetProperties

  • Статья

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

Метод GetProperties извлекает примитивные данные, на которые ссылаются TLV (тег, длина, значение) для указанного объекта.

Синтаксис

HRESULT GetProperties(
  [in]      REFTYPE     refType,
  [in]      BSTR        bstrPathSpec,
  [in]      SCARD_FLAGS flags,
  [in, out] LPTLV_TABLE *ppTLV
);

Параметры

refType [in]

Тип ссылки, используемой в bstrNewDir.

SC_TYPE_BY_NAME

SC_TYPE_BY_ID

SC_TYPE_BY_SHORT

SC_TYPE_BY_ANY

bstrPathSpec [in]

Файл.

flags [in]

Указывает, следует ли использовать безопасный обмен сообщениями.

SC_FL_SECURE_MESSAGING

ppTLV [in, out]

Указатель на структуры TLV, значение которых было извлечено.

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

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

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

 

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Окончание поддержки клиентов
 Windows XP
Окончание поддержки сервера
 Windows Server 2003

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

ISCardFileAccess