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 |
---|---|
|
Operação concluída com sucesso. |
|
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 |
|
Biblioteca de tipos |
|
DLL |
|
IID |
IID_ISCardCmd é definido como D5778AE3-43DE-11D0-9171-00AA00C18068 |
Confira também