Función SCardAddReaderToGroupA (winscard.h)

  • Artículo

La función SCardAddReaderToGroup agrega un lector a un grupo de lectores.

Sintaxis

LONG SCardAddReaderToGroupA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szReaderName,
  [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] szReaderName

Nombre para mostrar del lector que va a agregar.

[in] szGroupName

Nombre para mostrar del grupo al que va a agregar el lector.

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 de en qué grupo o grupos se encuentren 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
Success
 SCARD_S_SUCCESS.
Error
 Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

SCardAddReaderToGroup crea automáticamente el grupo de lectores especificado si aún no existe.

La función SCardAddReaderToGroup 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 agregar un lector de tarjetas inteligentes a un grupo. En el ejemplo se supone que lReturn es una variable existente de tipo LONG, que hContext es un identificador válido recibido de una llamada anterior a la función SCardEstablishContext y que el sistema conoce "MyReader" y "MyReaderGroup" mediante llamadas anteriores a las funciones SCardIntroduceReader y SCardIntroduceReaderGroup , respectivamente.


lReturn = SCardAddReaderToGroup( hContext, 
                                L"MyReader",
                                L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardAddReaderToGroup\n");

Nota

El encabezado winscard.h define SCardAddReaderToGroup 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

Consulte también

SCardEstablishContext

SCardIntroduceReader

SCardIntroduceReaderGroup

SCardRemoveReaderFromGroup