Método ISCard::Transaction
[O método Transaction está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Os Módulos de Cartão Inteligente fornecem funcionalidade semelhante.]
O método Transaction executa uma operação de gravação e leitura no objeto de comando smart cartão (unidade de dados de protocolo de aplicativo). A cadeia de caracteres de resposta do cartão inteligente para a cadeia de caracteres de comando definida na cartão que foi enviada para a cartão inteligente ficará acessível após o retorno dessa função.
Sintaxe
HRESULT Transaction(
[in, out] LPSCARDCMD *ppCmd
);
Parâmetros
-
ppCmd [in, out]
-
Um ponteiro para o objeto de comando smart cartão.
Valor retornado
O método retorna um dos valores possíveis a seguir.
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com sucesso. |
|
O parâmetro ppCmd não é válido. |
|
Um ponteiro inválido foi passado em ppCmd. |
|
A memória para atender à solicitação não está disponível. |
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 execução de uma operação de gravação e leitura no objeto de comando smart cartão.
HRESULT hr;
// pISCard is a pointer to an instance of ISCard.
// pISCardCmd is a pointer to an instance of ISCardCmd,
// and ISCardCmd::BuildCmd has already been called.
hr = pISCard->Transaction(&pISCardCmd);
if (FAILED(hr))
{
printf("Failed ISCard::Transaction\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_ISCard é definido como 1461AAC3-6810-11D0-918F-00AA00C18068 |
Confira também