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

Метод ISCardFileAccess::GetFileCapabilities

  • Статья

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

Метод GetFileCapabilities извлекает список возможностей файла из текущего файла.

Синтаксис

HRESULT GetFileCapabilities(
  [in, out] LPTLV_TABLE *ppProperties,
  [in, out] LONG        *plProperties,
  [in]      SCARD_FLAGS Flags
);

Параметры

ppProperties [in, out]

Указатель на структуры TLV (тег, длина, значение). Во входных данных этот параметр указывает файлы, для которых требуется получить свойства; в выходных данных этот параметр содержит свойства . В следующем примере показано определение структуры TLV.

#include <windows.h>

typedef struct
{
  DWORD  Tag;
  DWORD  Length;
  BYTE[]  Value;
  BOOL  Valid;
} TLV;

Дополнительные сведения о структурах TLV см. в разделе https://pcscworkgroup.com/.

plProperties [in, out]

Указатель на количество записей TLV в ppProperties.

Флаги [in]

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

SC_FL_SECURE_MESSAGING

SC_FL_PREALLOCATED

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

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

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

 

Комментарии

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

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

Требования

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

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

ISCardFileAccess