Método ISCard::get_Protocol
[O método get_Protocol 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_Protocol recupera o identificador do protocolo atualmente em uso na cartão inteligente.
Sintaxe
HRESULT get_Protocol(
[out] SCARD_PROTOCOLS *pProtocol
);
Parâmetros
-
pProtocol [out]
-
Ponteiro para o identificador de protocolo.
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 pProtocol não é válido. |
|
Um ponteiro inválido foi passado em pProtocol. |
Comentários
Além dos códigos de erro COM listados acima, essa interface poderá retornar um código de erro de cartão inteligente se uma função de cartão inteligente for chamada para concluir a solicitação. Para obter mais informações, consulte Valores retornados do cartão inteligente.
Exemplos
O exemplo a seguir mostra a recuperação do identificador do protocolo atualmente em uso na cartão inteligente.
SCARD_PROTOCOLS scProtocol;
HRESULT hr;
// Retrieve the protocol.
hr = pISCard->get_Protocol(&scProtocol);
if (FAILED(hr))
{
printf("Failed get_Protocol\n");
// Take other error handling action as needed.
}
// Use the retrieved protocol. (This example merely displays it.)
switch (scProtocol)
{
case T0:
printf("T0 protocol\n");
break;
case T1:
printf("T1 protocol\n");
break;
default:
printf("Other protocol\n");
break;
}
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_ISCard é definido como 1461AAC3-6810-11D0-918F-00AA00C18068 |
Confira também