共用方式為

ISCardLocate：：FindCard 方法

  • 發行項

[ FindCard 方法可用於需求一節中指定的作業系統。 它不適用於 Windows Server 2003 Service Pack 1 (SP1) 及更新版本、Windows Vista、Windows Server 2008 和後續版本的作業系統。 智慧卡模組提供類似的功能。]

FindCard方法會搜尋智慧卡，並開啟其有效的連線。

語法

HRESULT FindCard(
  [in]  SCARD_SHARE_MODES ShareMode,
  [in]  SCARD_PROTOCOLS   Protocols,
  [in]  LONG              lFlags,
  [out] LPSCARDINFO       *ppCardInfo
);

參數

ShareMode [in]

開啟連線時要共用或未共用智慧卡的模式。

值 意義
獨家
 其他人不會使用此智慧卡連線。
共用
 其他應用程式可以使用此連線。

 

通訊協定 [in]

連線到卡片時要使用的通訊協定。

T0

T1

RAW

T0|T1

lFlags [in]

指定何時顯示 使用者介面 ：

值 意義
SC_DLG_MINIMAL_UI
 只有在呼叫端應用程式所搜尋的卡片找不到且可用於讀取器時，才會顯示對話方塊。 這可讓卡片找到、透過內部對話方塊機制連線 (，或使用使用者回呼函式) ，並傳回給呼叫的應用程式。
SC_DLG_NO_UI
 不顯示任何 UI，不論搜尋結果為何。
SC_DLG_FORCE_UI
 無論搜尋結果為何，都會導致 UI 顯示。

 

ppCardInfo [out]

如果成功，指向包含或傳回已開啟 之智慧卡相關資訊的資料結構指標。 如果作業失敗，將會是 Null 。

傳回值

方法會傳回下列其中一個可能的值。

傳回碼 描述
S_OK
 作業順利完成。
E_INVALIDARG
 無效的參數。
E_POINTER
 在 ppCardInfo中傳遞不正確的指標。
E_OUTOFMEMORY
 記憶體不足。

 

備註

若要設定搜尋的搜尋準則，請呼叫 ConfigureCardNameSearch 以指定智慧卡的卡片名稱。

如需此介面提供之所有方法的清單，請參閱 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

另請參閱

ConfigureCardNameSearch

ISCardLocate