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");