Función SCardForgetReaderGroupA (winscard.h)

La función SCardForgetReaderGroup quita una tarjeta inteligente grupo de lectores del subsistema de tarjeta inteligente . Aunque esta función borra automáticamente todos los lectores del grupo, no afecta a la existencia de los lectores individuales en 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 de . 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	Significado
SCARD_ALL_READERS TEXT("SCard$AllReaders\000")	Grupo usado cuando no se proporciona ningún nombre de grupo al enumerar lectores. Devuelve una lista de todos los lectores, independientemente del grupo o grupos en los que se encuentran los lectores.
SCARD_DEFAULT_READERS TEXT("SCard$DefaultReaders\000")	Grupo predeterminado al que se agregan todos los lectores cuando se introducen en el sistema.
SCARD_LOCAL_READERS TEXT("SCard$LocalReaders\000")	Valor heredado sin usar. Se trata de un grupo administrado internamente que no se puede modificar mediante ninguna API de grupo de lectores. Está pensado para usarse solo para la enumeración.
SCARD_SYSTEM_READERS TEXT("SCard$SystemReaders\000")	Valor heredado sin usar. Se trata de un grupo administrado internamente que no se puede modificar mediante ninguna API de grupo de lectores. Está pensado para usarse solo para la enumeración.

Valor devuelto

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

Código devuelto	Descripción
correcto	SCARD_S_SUCCESS.
error de	Un código de error. Para obtener más información, consulte valores devueltos de tarjeta inteligente.

Observaciones

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 de 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 LONGy que hContext es un identificador válido para un contexto de Resource Manager obtenido previamente de una llamada a la función SCardEstablishContext de .

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 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winscard.h
biblioteca de	Winscard.lib
DLL de	Winscard.dll

Consulte también

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardIntroduceReaderGroup