Función SCardForgetReaderA (winscard.h)
La función SCardForgetReader quita un lector introducido previamente del control por el subsistema de tarjeta inteligente. Se quita de la base de datos de tarjeta inteligente, incluido de cualquier grupo de lectores al que se pueda haber agregado.
Sintaxis
LONG SCardForgetReaderA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName
);
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] szReaderName
Nombre para mostrar del lector 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 se produce un error.
Código devuelto | Descripción |
---|---|
|
SCARD_S_SUCCESS. |
|
Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente. |
Comentarios
Si el lector especificado es el último miembro de un grupo de lectores, el grupo de lectores también se quita automáticamente.
La función SCardForgetReader 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 nombre para mostrar del lector de tarjetas especificado del sistema. En el ejemplo se supone que lReturn es una variable válida de tipo LONG y que hContext es un identificador válido recibido de una llamada anterior a la función SCardEstablishContext .
lReturn = SCardForgetReader(hContext,
TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReader\n");
Nota:
El encabezado winscard.h define SCardForgetReader 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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 |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de