ISCardISO7816：：Verify 方法

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

Verify方法會建構應用程式通訊協定資料單位 (APDU) 命令，以起始從介面 (裝置傳送之驗證資料的比較 () ，例如密碼) 。

語法

HRESULT Verify(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

參數

byRefCtrl [in]

參考資料的數量詞。 參考控制項 P2 的程式碼如下。

當本文是空的時，可以使用 命令來擷取進一步允許的重試次數 'X'， (SW1-SW2=63CX) ，或檢查驗證是否不需要 (SW1-SW2=9000) 。

值	意義
無資訊	位位置：00000000 P2=00 已保留，表示驗證命令明確參考秘密資料的卡片中不會使用任何特定的限定詞。
全域參考	位位置：0------- 全域參考的範例是密碼。
特定 Ref	位位置：1------- 特定 Ref 的範例是 DF 特定密碼。
RFU	位位置：-xx-----
Ref 資料#	位位置：---xxxxx 參考資料編號可能是密碼號碼或簡短 EF 識別碼。

 

pData [in]

驗證資料的指標。 此參數可以是 Null。 預設值是 NULL。

ppCmd [in， out]

在輸入時， ISCardCmd 介面物件的指標或 Null。

傳回時，它會填入此作業所建構的 APDU 命令。 如果ppCmd設定為Null，則會使用ppCmd指標在內部建立並傳回智慧卡ISCardCmd物件。

傳回值

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

傳回碼	描述
S_OK	作業已成功完成。
E_INVALIDARG	使用不正確參數。
E_POINTER	傳入不正確的指標。
E_OUTOFMEMORY	記憶體不足。

 

備註

安全性狀態可能會因為比較而修改。 例如，不成功的比較可能會記錄在卡片 (中，以限制使用參考資料) 的進一步嘗試次數。

如需此介面提供之所有方法的清單，請參閱 ISCardISO7816。

除了上面所列的 COM 錯誤碼之外，如果呼叫智慧卡函式以完成要求，此介面可能會傳回智慧卡錯誤碼。 如需詳細資訊，請參閱 智慧卡傳回值。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
用戶端支援結束	Windows XP
伺服器終止支援	Windows Server 2003
標頭	Scardssp.h
類型程式庫	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816定義為 53B6AA68-3F56-11D0-916B-00AA00C18068

另請參閱

ISCardISO7816