共用方式為

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，因此不會發生任何通訊協定交涉。 讀取器中可能沒有卡片。

傳回值

此函式會根據它是否成功或失敗，傳回不同的值。

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

言論

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

例子

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

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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winscard.h
連結庫 Winscard.lib
DLL Winscard.dll

另請參閱

SCardControl

SCardDisconnect

SCardEstablishContext

SCardReconnect