SCardConnectA 函式 (winscard.h)

  • 發行項

SCardConnect 函式會使用呼叫應用程式與特定讀取器所包含智慧卡之間的特定資源管理員內容) 建立連線 (。 如果指定的讀取器中沒有卡片存在，則會傳回錯誤。

語法

LONG SCardConnectA(
  [in]  SCARDCONTEXT  hContext,
  [in]  LPCSTR        szReader,
  [in]  DWORD         dwShareMode,
  [in]  DWORD         dwPreferredProtocols,
  [out] LPSCARDHANDLE phCard,
  [out] LPDWORD       pdwActiveProtocol
);

參數

[in] hContext

識別 資源管理員內容的句柄。 資源管理員內容是由先前對 SCardEstablishContext 的呼叫所設定。

[in] szReader

包含目標卡片的讀取器名稱。

[in] dwShareMode

旗標，指出其他應用程式是否可以形成卡片的連線。

值 意義
SCARD_SHARE_SHARED
 此應用程式願意與其他應用程式共用卡片。
SCARD_SHARE_EXCLUSIVE
 此應用程式不願意與其他應用程式共用卡片。
SCARD_SHARE_DIRECT
 此應用程式正在配置讀取器供其私用使用，並直接控制它。 不允許其他應用程式存取它。

[in] dwPreferredProtocols

線上可接受的通訊協定位掩碼。 可能的值可以與 OR 作業結合。

值 意義
SCARD_PROTOCOL_T0
 T=0 是可接受的通訊協定。
SCARD_PROTOCOL_T1
 T=1 是可接受的通訊協定。
0
 只有當 dwShareMode 設定為 SCARD_SHARE_DIRECT 時，這個參數才會是零。 在此情況下，驅動程式不會執行任何通訊協定交涉，直到使用 SCardControl 傳送IOCTL_SMARTCARD_SET_PROTOCOL控制指示詞為止。

[out] phCard

句柄，識別所指定讀取器中 智慧卡 的連線。

[out] pdwActiveProtocol

旗標，表示已建立的作用中通訊協定。

值 意義
SCARD_PROTOCOL_T0
 T=0 是作用中的通訊協定。
SCARD_PROTOCOL_T1
 T=1 是作用中的通訊協定。
SCARD_PROTOCOL_UNDEFINED
 已指定SCARD_SHARE_DIRECT，因此不會發生通訊協定交涉。 讀取器中可能沒有卡片。

傳回值

此函式會傳回不同的值，視其成功或失敗而定。

傳回碼 Description
「成功」
 SCARD_S_SUCCESS。
失敗
 錯誤碼。 如需詳細資訊，請參閱 智慧卡傳回值。
SCARD_E_NOT_READY
 讀取器無法連線到卡片。

備註

SCardConnect 函式是智慧卡和讀取器存取函式。 如需其他存取函式的詳細資訊，請參閱 智慧卡和讀取器存取函式。

範例

下列範例會建立與讀取器的連線。 此範例假設 hContext 是從先前呼叫 SCardEstablishContext 收到的 SCARDCONTEXT 類型的有效句柄。

SCARDHANDLE     hCardHandle;
LONG            lReturn;
DWORD           dwAP;

lReturn = SCardConnect( hContext, 
                        (LPCTSTR)"Rainbow Technologies SCR3531 0",
                        SCARD_SHARE_SHARED,
                        SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                        &hCardHandle,
                        &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardConnect\n");
    exit(1);  // Or other appropriate action.
}

// Use the connection.
// Display the active protocol.
switch ( dwAP )
{
    case SCARD_PROTOCOL_T0:
        printf("Active protocol T0\n"); 
        break;

    case SCARD_PROTOCOL_T1:
        printf("Active protocol T1\n"); 
        break;

    case SCARD_PROTOCOL_UNDEFINED:
    default:
        printf("Active protocol unnegotiated or unknown\n"); 
        break;
}

// Remember to disconnect (by calling SCardDisconnect).
// ...

注意

winscard.h 標頭會將 SCardConnect 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winscard.h
程式庫 Winscard.lib
Dll Winscard.dll

另請參閱

SCardControl

SCardDisconnect

SCardEstablishContext

SCardReconnect