Función SCardLocateCardsByATRA (winscard.h)

La función SCardLocateCardsByATR busca en los lectores enumerados en el parámetro rgReaderStates para una tarjeta con un nombre que coincida con uno de los nombres de tarjeta contenidos en una de las estructuras SCARD_ATRMASK especificadas por el parámetro rgAtrMasks.

Sintaxis

LONG SCardLocateCardsByATRA(
  [in]      SCARDCONTEXT         hContext,
  [in]      LPSCARD_ATRMASK      rgAtrMasks,
  [in]      DWORD                cAtrs,
  [in, out] LPSCARD_READERSTATEA rgReaderStates,
  [in]      DWORD                cReaders
);

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.

[in] rgAtrMasks

Matriz de SCARD_ATRMASK estructuras que contienen los nombres de las tarjetas para las que se va a buscar.

[in] cAtrs

Número de elementos de la matriz de rgAtrMasks.

[in, out] rgReaderStates

Matriz de SCARD_READERSTATE estructuras que especifican los lectores que se van a buscar y reciben el resultado.

[in] cReaders

Número de elementos de la matriz de rgReaderStates.

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	Código de error. Para obtener más información, consulte valores devueltos de tarjeta inteligente.

Observaciones

Este servicio es especialmente útil cuando se usa junto con SCardGetStatusChange. Si no se encuentra ninguna tarjeta coincidente por medio de SCardLocateCards, la aplicación que realiza la llamada puede usar SCardGetStatusChange para esperar cambios de disponibilidad de tarjetas.

La función SCardLocateCardsByATR es una función de seguimiento de tarjeta inteligente. Para obtener información sobre otras funciones de seguimiento, consulte funciones de seguimiento de tarjetas inteligentes.

Nota

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