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 |
---|---|
|
SCARD_S_SUCCESS. |
|
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 |