Función SCardIntroduceReaderGroupW (winscard.h)

Artículo
08/27/2023

La función SCardIntroduceReaderGroup introduce un grupo de lectores en el subsistema de tarjetas inteligentes . Sin embargo, el grupo de lectores no se crea hasta que se especifica el grupo al agregar un lector a la base de datos de tarjetas inteligentes.

Sintaxis

LONG SCardIntroduceReaderGroupW(
  [in] SCARDCONTEXT hContext,
  [in] LPCWSTR      szGroupName
);

Parámetros

[in] hContext

Proporciona el identificador que identifica el contexto del administrador de recursos. El contexto del administrador de recursos se establece mediante una llamada anterior a la función SCardEstablishContext . Si este parámetro es NULL, el ámbito del administrador de recursos se SCARD_SCOPE_SYSTEM.

[in] szGroupName

Proporciona el nombre para mostrar que se asignará al nuevo grupo de lectores.

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

La función SCardIntroduceReaderGroup se proporciona para la compatibilidad con la especificación PC/SC. Los grupos de lectores no se almacenan hasta que se agrega un lector al grupo.

La función SCardIntroduceReaderGroup es una función de administración de bases de datos. Para obtener una descripción de otras funciones de administración de bases de datos, consulte Funciones de administración de bases de datos de tarjeta inteligente.

Para quitar un grupo de lectores, use SCardForgetReaderGroup.

Ejemplos

En el ejemplo siguiente se muestra cómo introducir un grupo de lectores de tarjetas inteligentes.

// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext, 
                                    L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceReaderGroup\n");

Nota

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