Função SCardLocateCardsByATRA (winscard.h)

A função SCardLocateCardsByATR pesquisa os leitores listados no parâmetro rgReaderStates para um cartão com um nome que corresponde a um dos nomes de cartão contidos em uma das estruturas de SCARD_ATRMASK especificadas pelo parâmetro rgAtrMasks.

Sintaxe

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 o contexto do gerenciador de recursos. O contexto do gerenciador de recursos é definido por uma chamada anterior para SCardEstablishContext.

[in] rgAtrMasks

Matriz de estruturas SCARD_ATRMASK que contêm os nomes dos cartões para os quais pesquisar.

[in] cAtrs

Número de elementos na matriz rgAtrMasks .

[in, out] rgReaderStates

Matriz de estruturas SCARD_READERSTATE que especificam os leitores a pesquisar e receber o resultado.

[in] cReaders

Número de elementos na matriz rgReaderStates .

Valor retornado

Essa função retorna valores diferentes dependendo se ela é bem-sucedida ou falha.

Código de retorno	Descrição
Êxito	SCARD_S_SUCCESS.
Falha	Código do erro. Para obter mais informações, consulte Valores retornados do cartão inteligente.

Comentários

Esse serviço é especialmente útil quando usado em conjunto com SCardGetStatusChange. Se nenhum cartão correspondente for encontrado por meio de SCardLocateCards, o aplicativo de chamada poderá usar SCardGetStatusChange para aguardar cartão alterações de disponibilidade.

A função SCardLocateCardsByATR é uma função de controle de cartão inteligente. Para obter informações sobre outras funções de acompanhamento, consulte Funções de acompanhamento de cartão inteligente.

Observação

O cabeçalho winscard.h define SCardLocateCardsByATR como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winscard.h
Biblioteca	Winscard.lib
DLL	Winscard.dll