通过

ISCardLocate：：ConfigureCardNameSearch 方法

  • 项目

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

ConfigureCardNameSearch 方法指定要在智能卡搜索中使用的卡名称。

语法

HRESULT ConfigureCardNameSearch(
  [in] LPSAFEARRAY pCardNames,
  [in] LPSAFEARRAY pGroupNames,
  [in] BSTR        bstrTitle,
  [in] LONG        lFlags
);

parameters

pCardNames [in]

指向 BSTR 格式卡名称的自动化安全数组的指针。

pGroupNames [in]

指向自动化安全数组的指针，该数组以 BSTR 形式添加到搜索中卡/读取者组的名称。

bstrTitle [in]

搜索通用控件的对话框标题。

lFlags [in]

指定 用户界面的 显示时间。

值 含义
SC_DLG_MINIMAL_UI
 仅当调用应用程序搜索的卡未找到且可用于读取器时，才显示对话框。 这允许找到卡，通过内部对话框机制或使用用户回调函数) 连接 (，并返回到调用应用程序。
SC_DLG_NO_UI
 无论搜索结果如何，都会导致不显示 UI。
SC_DLG_FORCE_UI
 无论搜索结果如何，都会导致 UI 显示。

 

返回值

方法返回以下可能值之一。

返回代码 说明
S_OK
 操作已成功完成。
E_INVALIDARG
 参数无效。
E_POINTER
 pCardNames 或 pGroupNames 中传递了错误的指针。
E_OUTOFMEMORY
 内存不足。

 

备注

若要查找智能卡，请调用 FindCard。

有关此接口提供的所有方法的列表，请参阅 ISCardLocate。

除了上面列出的 COM 错误代码外，如果调用智能卡函数来完成请求，则此接口可能返回智能卡错误代码。 有关详细信息，请参阅 智能卡返回值。

要求

要求 值
最低受支持的客户端
 Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
客户端支持终止
 Windows XP
终止服务器支持
 Windows Server 2003
标头
Scardmgr.h
类型库
Scardmgr.tlb
DLL
Scardssp.dll
IID
 IID_ISCardLocate定义为 1461AACD-6810-11D0-918F-00AA00C18068

另请参阅

FindCard

ISCardLocate