Função GetOpenCardNameA (winscard.h)

A função GetOpenCardName exibe a caixa de diálogo cartão inteligente "selecionar cartão". Chame a função SCardUIDlgSelectCard em vez de GetOpenCardName. A função GetOpenCardName é mantida para compatibilidade com versões anteriores com a versão 1.0 dos Componentes Base de Cartão Inteligente da Microsoft, mas as chamadas para GetOpenCardName são mapeadas para SCardUIDlgSelectCard.

Sintaxe

LONG GetOpenCardNameA(
  [in] LPOPENCARDNAMEA unnamedParam1
);

Parâmetros

[in] unnamedParam1

Um ponteiro para a estrutura OPENCARDNAME para a caixa de diálogo "selecionar cartão".

Valor de retorno

A 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 GetOpenCardName 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	Scarddlg.lib
de DLL	Scarddlg.dll

Consulte também

OPENCARDNAME