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

另請參閱

SCardConnect

SCardEndTransaction