Funzione SCardForgetCardTypeA (winscard.h)

Articolo
08/27/2023

La funzione SCardForgetCardType rimuove una smart card introdotta dal sottosistema smart card.

Sintassi

LONG SCardForgetCardTypeA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager viene impostato da una chiamata precedente a SCardEstablishContext. Questo parametro non può essere NULL.

[in] szCardName

Nome visualizzato della scheda da rimuovere dal database della smart card.

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 della smart card.

Commenti

Questa funzione non viene reindirizzata, ma la chiamata alla funzione SCardForgetCardType quando all'interno di una sessione desktop remoto non verrà generato un errore. Significa solo che il risultato sarà dal computer remoto anziché dal computer locale.

La funzione SCardForgetCardType è una funzione di gestione del database. Per altre informazioni sulle altre funzioni di gestione del database, vedere Funzioni di gestione del database smart card.

Esempio

Nell'esempio seguente viene rimosso il tipo di scheda specificato dal sistema. L'esempio presuppone che lReturn sia una variabile valida di tipo LONG, che hContext sia un handle valido ricevuto da una chiamata precedente alla funzione SCardEstablishContext e che "MyCardName" sia stato introdotto in precedenza da una chiamata alla funzione SCardIntroduceCardType .


lReturn = SCardForgetCardType(hContext, 
                              L"MyCardName");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetCardType\n");

Nota

L'intestazione winscard.h definisce SCardForgetCardType come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


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

SCardForgetReader

SCardForgetReaderGroup

SCardIntroduceCardType