Função SCardLocateCardsByATRA (winscard.h)

Artigo
11/20/2024

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 ode 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 de SCARD_READERSTATE que especificam os leitores para pesquisar e receber o resultado.

[in] cReaders

Número de elementos na matriz de rgReaderStates.

Valor de retorno

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

Código de retorno	Descrição
de sucesso do	SCARD_S_SUCCESS.
de falha do	Código de erro. Para obter mais informações, consulte valores de retorno de cartão inteligente.

Observações

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 as alterações de disponibilidade do cartão.

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winscard.h
biblioteca	Winscard.lib
de DLL	Winscard.dll

Compartilhar via