共用方式為


SCardCancel 函式 (winscard.h)

SCardCancel 函式會終止特定資源管理員內容中的所有未完成動作。

您可以取消的唯一要求是需要 由智慧卡 或使用者等候外部動作的要求。 任何這類未完成的動作要求都會終止,並顯示動作已取消的狀態指示。 這特別適合強制未處理的 SCardGetStatusChange 呼叫終止。

語法

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

參數

[in] hContext

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

傳回值

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

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

備註

SCardCancel 函式是智慧卡追蹤函式。 如需其他追蹤函式的描述,請參閱 智慧卡追蹤函式

範例

下列範例會取消指定內容中的所有未完成動作。 此範例假設 lReturn 是 LONG 類型的現有變數,而 hContext 是先前呼叫 SCardEstablishContext 所收到的有效句柄。


lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

規格需求

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

另請參閱

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards