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
);

參數

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