Funzione SCardCancel (winscard.h)

  • Articolo

La funzione SCardCancel termina tutte le azioni in sospeso all'interno di un contesto specifico di Resource Manager.

Le uniche richieste che è possibile annullare sono quelle che richiedono l'attesa dell'azione esterna da parte dell'utente o della smart card . Qualsiasi richiesta di azione in sospeso termina con un'indicazione di stato che l'azione è stata annullata. Ciò è particolarmente utile per forzare l'interruzione delle chiamate SCardGetStatusChange .

Sintassi

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente a SCardEstablishContext.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito Descrizione
Success
 SCARD_S_SUCCESS.
Operazioni non riuscite
 Codice di errore. Per altre informazioni, vedere Valori restituiti smart card.

Commenti

La funzione SCardCancel è una funzione di rilevamento smart card. Per una descrizione di altre funzioni di rilevamento, vedere Funzioni di rilevamento smart card.

Esempio

Nell'esempio seguente vengono annullate tutte le azioni in sospeso nel contesto specificato. L'esempio presuppone che lReturn sia una variabile di tipo LONG esistente e che hContext sia un handle valido ricevuto da una chiamata precedente a SCardEstablishContext.


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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winscard.h
Libreria Winscard.lib
DLL Winscard.dll

Vedi anche

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards