Função SCardGetDeviceTypeIdA (winscard.h)

Artigo
11/20/2024

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 é listada em membro ReaderType na estrutura SCARD_READER_CAPABILITIES.

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	Um código de erro. Para obter mais informações, consulte valores de retorno de cartão inteligente.

Observações

Nota

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. 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 8 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winscard.h
de DLL	Winscard.dll

Compartilhar via