Partilhar via


IOCTL_SMARTCARD_GET_STATE IOCTL (winsmcrd.h)

O código de controle IOCTL_SMARTCARD_GET_STATE obtém a status atual do cartão inteligente.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Buffer de saída

(DWORD) um dos seguintes estados:

Estado Descrição
SCARD_UNKNOWN Estado desconhecido
SCARD_ABSENT O cartão não foi detectado
SCARD_SWALLOWED O cartão está presente, mas não está ligado. Quando SCARD_POWER_DOWN é definido.
SCARD_SPECIFIC O cartão está presente e os protocolos de comunicação são estabelecidos.

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Os códigos de erro possíveis são:

Código de retorno Descrição
STATUS_INVALID_PARAMETER Esse código é retornado quando os buffers de entrada ou saída são inválidos.
STATUS_BUFFER_TOO_SMALL Esse código será retornado se o buffer de saída for muito pequeno para os dados de retorno.
STATUS_DEVICE_POWERED_OFF Esse código será retornado se o controle de rádio de proximidade estiver desativado.

Requisitos

Requisito Valor
Cabeçalho winsmcrd.h

Confira também

Guia de design da NFC (comunicação de campo próximo)

Guia de design de cartão inteligente