Función SCardLocateCardsByATRA (winscard.h)

La función SCardLocateCardsByATR busca en los lectores enumerados en el parámetro rgReaderStates una tarjeta con un nombre que coincida con uno de los nombres de tarjeta contenidos en una de las estructuras de 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. El contexto del administrador de recursos se establece mediante una llamada anterior a SCardEstablishContext.

[in] rgAtrMasks

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

[in] cAtrs

Número de elementos de la matriz rgAtrMasks .

[in, out] rgReaderStates

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

[in] cReaders

Número de elementos de la matriz rgReaderStates .

Valor devuelto

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

Comentarios

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

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

Requisitos