Función SCardForgetCardTypeA (winscard.h)

Artículo
08/27/2023

La función SCardForgetCardType quita una tarjeta inteligente introducida del subsistema de tarjetas inteligentes.

Sintaxis

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

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos. El contexto del administrador de recursos se establece mediante una llamada anterior a SCardEstablishContext. Este parámetro no puede ser NULL.

[in] szCardName

Nombre para mostrar de la tarjeta que se va a quitar de la base de datos de tarjetas inteligentes.

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o no.

Código devuelto	Descripción
Success	SCARD_S_SUCCESS.
Error	Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

Esta función no se redirige, pero al llamar a la función SCardForgetCardType cuando dentro de una sesión de Escritorio remoto no se producirá un error. Solo significa que el resultado será del equipo remoto en lugar del equipo local.

La función SCardForgetCardType es una función de administración de bases de datos. Para obtener más información sobre otras funciones de administración de bases de datos, consulte Funciones de administración de bases de datos de tarjeta inteligente.

Ejemplos

En el ejemplo siguiente se quita el tipo de tarjeta especificado del sistema. En el ejemplo se supone que lReturn es una variable válida de tipo LONG, que hContext es un identificador válido recibido de una llamada anterior a la función SCardEstablishContext y que anteriormente se introdujo "MyCardName" mediante una llamada a la función SCardIntroduceCardType .


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

Nota:

El encabezado winscard.h define SCardForgetCardType como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winscard.h
Library	Winscard.lib
Archivo DLL	Winscard.dll