Función SCardForgetReaderGroupA (winscard.h)
La función SCardForgetReaderGroup quita un grupo de lectores de tarjetas inteligentes introducido anteriormente del subsistema de tarjetas inteligentes. Aunque esta función borra automáticamente todos los lectores del grupo, no afecta a la existencia de los lectores individuales de la base de datos.
Sintaxis
LONG SCardForgetReaderGroupA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szGroupName
);
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] szGroupName
Nombre para mostrar del grupo de lectores que se va a quitar. Los grupos de lectores definidos por el sistema no se pueden quitar de la base de datos.
Valor devuelto
Esta función devuelve valores diferentes en función de si se realiza correctamente o no.
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
La función SCardForgetReaderGroup 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 con tarjeta inteligente.
Ejemplos
En el ejemplo siguiente se muestra cómo quitar un grupo de lectores del sistema. En el ejemplo se supone que lReturn es una variable existente de tipo LONG y que hContext es un identificador válido para un contexto del administrador de recursos obtenido anteriormente de una llamada a la función SCardEstablishContext .
lReturn = SCardForgetReaderGroup(hContext,
L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReaderGroup\n");
Nota
El encabezado winscard.h define SCardForgetReaderGroup 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
Requisito | Value |
---|---|
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 |