Método ISCardCmd::get_AlternateClassId

[O método get_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 get_AlternateClassId recupera o valor da ID de classe alternativa. Esse método falhará, a menos que a ID alternativa tenha sido definida por uma chamada anterior para put_AlternateClassId.

Sintaxe

HRESULT get_AlternateClassId(
  [out] BYTE *pbyClass
);

Parâmetros

pbyClass [out]

Ponteiro para o byte que contém o valor de ID de classe alternativa no retorno.

Valor retornado

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

Código de retorno	Descrição
S_OK	A operação foi concluída com êxito.
E_INVALIDARG	O parâmetro pbyClass não é válido.
E_ACCESSDENIED	A ID de classe alternativa não foi definida anteriormente por uma chamada para put_AlternateClassId.

 

Comentários

Esse método se aplica às comunicações usando o protocolo T=0. Para obter mais informações, consulte put_AlternateClassId.

Exemplos

O exemplo a seguir mostra como recuperar a ID de classe alternativa. O exemplo pressupõe que pISCardCmd é um ponteiro válido para uma instância da interface ISCardCmd .

BYTE     byAltClassID;
HRESULT  hr;

// Retrieve the alternate class ID.
hr = pISCardCmd->get_AlternateClassId(&byAltClassID);
if (FAILED(hr))
{
  printf("Failed get_AltClassId\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

put_AlternateClassId