Função SCardGetDeviceTypeIdA (winscard.h)

  • Artigo

A função SCardGetDeviceTypeId obtém o identificador de tipo de dispositivo do leitor de cartão para o nome do leitor fornecido. Essa função não afeta o estado do leitor.

Sintaxe

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Parâmetros

[in] hContext

Identificador que identifica o contexto do gerenciador de recursos para a consulta. Você pode definir o contexto do gerenciador de recursos chamando a função SCardEstablishContext . Esse parâmetro não pode ser NULL.

[in] szReaderName

Nome do leitor. Você pode obter esse valor chamando a função SCardListReaders .

[in, out] pdwDeviceTypeId

O identificador de tipo de dispositivo real. A lista de tipos de leitor retornados por essa função está listada em Membro ReaderType na estrutura SCARD_READER_CAPABILITIES .

Retornar valor

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

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

Comentários

Observação

O cabeçalho winscard.h define SCardGetDeviceTypeId 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

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winscard.h
DLL Winscard.dll