Método ISCard::get_CardHandle
[O método get_CardHandle 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 funcionalidades semelhantes.]
O método get_CardHandle recupera o identificador de um cartão inteligente conectado. Esse método retorna (*pHandle) == NULL se não estiver conectado.
Sintaxe
HRESULT get_CardHandle(
[out] HSCARD *pHandle
);
Parâmetros
-
pHandle [out]
-
Ponteiro para o identificador de cartão no retorno.
Valor retornado
O método retorna um dos seguintes valores possíveis.
| Código de retorno | Descrição |
|---|---|
|
Operação concluída com sucesso. |
|
O parâmetro pHandle não é válido. |
|
Um ponteiro ruim foi passado em pHandle. |
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 de Retorno do Cartão Inteligente.
Exemplos
O exemplo a seguir mostra a recuperação do identificador de cartão inteligente.
HSCARD hSC;
HRESULT hr;
// Retrieve the card handle.
hr = pISCard->get_CardHandle(&hSC);
if (FAILED(hr))
{
printf("Failed get_CardHandle\n");
// Take other error handling action as needed.
}
// Use card handle 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_ISCard é definido como 1461AAC3-6810-11D0-918F-00AA00C18068 |
Confira também