通过

ISCardFileAccess：：GetFileCapabilities 方法

  • 项目

[ GetFileCapabilities 方法可用于“要求”部分中指定的操作系统。 它不适用于 Windows Server 2003 Service Pack 1 (SP1) 及更高版本、Windows Vista、Windows Server 2008 和操作系统的后续版本。 智能卡模块提供类似的功能。]

GetFileCapabilities 方法从当前文件检索文件功能列表。

语法

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

parameters

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]

指向 ppProperties 中 TLV 条目数的指针。

Flags [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