Compartilhar via


Método ISCardCmd::p ut_AlternateClassId

[O método put_AlternateClassId está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. Os Módulos de Cartão Inteligente fornecem funcionalidade semelhante.]

O método put_AlternateClassId especifica um novo identificador de classe alternativo na APDU ( unidade de dados do protocolo de aplicativo ).

Sintaxe

HRESULT put_AlternateClassId(
  [in] BYTE byClass
);

Parâmetros

byClass [in]

Identificador de classe alternativo. O valor padrão é zero.

Valor retornado

O método retorna um dos valores possíveis a seguir.

Código de retorno Descrição
S_OK
Operação concluída com sucesso.
E_INVALIDARG
O parâmetro byClass não é válido.

 

Comentários

Com as comunicações usando o protocolo T=0, comandos de cartão adicionais podem ser gerados automaticamente pela APDU e enviados para a TPDU (unidade de dados do protocolo de transmissão). Os comandos adicionais normalmente usam a mesma ID de classe que o comando original; especificar uma nova ID de classe por meio desse método permite que comandos gerados automaticamente usem a nova ID de classe.

Exemplos

O exemplo a seguir mostra como definir um novo identificador de classe alternativo na APDU ( unidade de dados do protocolo de aplicativo ). O exemplo pressupõe que pISCardCmd é um ponteiro válido para uma instância da interface ISCardCmd .

HRESULT  hr;

// Set the class ID.
hr = pISCardCmd->put_AlternateClassId(0xC0);
if (FAILED(hr))
{
  printf("Failed put_AlternateClassId\n");
  // Take other error handling action as needed.
}

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]
Fim do suporte ao cliente
Windows XP
Fim do suporte ao servidor
Windows Server 2003
Cabeçalho
Scarddat.h
Biblioteca de tipos
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardCmd é definido como D5778AE3-43DE-11D0-9171-00AA00C18068

Confira também

ISCardCmd

get_AlternateClassId