SCardBeginTransaction 函式 (winscard.h)
SCardBeginTransaction 函式會啟動交易。
函式會在開始之前等候完成所有其他交易。 交易開始之後，所有其他應用程式都會在交易進行時遭到封鎖，而無法存取 智慧卡 。
語法
LONG SCardBeginTransaction(
[in] SCARDHANDLE hCard
);
參數
[in] hCard
從先前呼叫 SCardConnect 取得的參考值。
傳回值
如果函式成功，則會 傳回SCARD_S_SUCCESS。
如果函式失敗，它會傳回錯誤碼。 如需詳細資訊，請參閱 智慧卡傳回值。
如果另一個進程或線程已重設卡片，SCARD_W_RESET_CARD會如預期般傳回。
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 即使另一個進程或線程已重設卡片，此函式仍會 傳回SCARD_S_SUCCESS 。 若要判斷卡片是否已重設，請在呼叫此函式之後立即呼叫 SCardStatus 函式。
備註
如果交易在卡片上保留超過五秒，且該卡片上沒有發生任何作業，則會重設卡片。 在交易的卡片上呼叫任何 智慧卡和讀取器存取 函式或 直接卡片存取函 式，會導致定時器重設，以繼續允許使用交易。
SCardBeginTransaction 函式是智慧卡和讀取器存取函式。 如需其他存取函式的詳細資訊，請參閱 智慧卡和讀取器存取函式。
範例
下列範例示範如何開始智慧卡交易。 此範例假設 lReturn 是 LONG 類型的現有變數， hCard 而且是從先前呼叫 SCardConnect 收到的有效句柄。
lReturn = SCardBeginTransaction( hCard );
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardBeginTransaction\n");
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | winscard.h |
| 程式庫 | Winscard.lib |
| Dll | Winscard.dll |