Função GetOpenCardNameW (winscard.h)

  • Artigo

A função GetOpenCardName exibe a caixa de diálogo "selecionar cartão" do cartão inteligente. 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 GetOpenCardNameW(
  [in] LPOPENCARDNAMEW unnamedParam1
);

Parâmetros

[in] unnamedParam1

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

Retornar valor

A 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 do cartão inteligente.

Comentários

Observação

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

Confira também

OPENCARDNAME