SCardDisconnect 函式 (winscard.h)

SCardDisconnect函式會終止先前在呼叫應用程式與目標讀取器中的智慧卡之間開啟的連接。

語法

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

參數

[in] hCard

從先前呼叫 SCardConnect取得的參考值。

[in] dwDisposition

關閉連接讀取器中卡片上要採取的動作。

值	意義
SCARD_LEAVE_CARD	請勿執行任何特殊動作。
SCARD_RESET_CARD	重設卡片。
SCARD_UNPOWER_CARD	將卡片關閉電源。
SCARD_EJECT_CARD	退出卡片。

傳回值

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

傳回碼	描述
「成功」	SCARD_S_SUCCESS。
失敗	錯誤碼。 如需詳細資訊，請參閱 智慧卡傳回值。

備註

如果先前稱為 SCardConnect 的應用程式 () 結束而不呼叫 SCardDisconnect，則會自動重設卡片。

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

範例

下列範例會終止指定的智慧卡連線。 此範例假設 lReturn 是 LONG類型的變數，而 hCardHandle 是從先前呼叫 SCardConnect收到的有效控制碼。

lReturn = SCardDisconnect(hCardHandle, 
                          SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardDisconnect\n");
    exit(1);  // Or other appropriate action.
}

規格需求

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

另請參閱

SCardConnect

SCardReconnect