共用方式為


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 函式是智慧卡讀取器存取函式。 如需其他存取函式的詳細資訊,請參閱 智慧卡和讀取器存取函式

範例

下列範例示範如何開始智慧卡交易。 此範例假設 lReturnLONG 類型的現有變數, 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

另請參閱

SCardConnect

SCardEndTransaction