Função SCardIsValidContext (winscard.h)

A função SCardIsValidContext determina se um identificador de contexto de cartão inteligente é válido.

Sintaxe

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Parâmetros

[in] hContext

Identificador que identifica o contexto do gerenciador de recursos. O contexto do gerenciador de recursos pode ser definido por uma chamada anterior para SCardEstablishContext.

Retornar valor

Essa função retorna um dos valores a seguir.

Código de retorno	Descrição
SCARD_S_SUCCESS	O parâmetro hContext é válido.
ERROR_INVALID_HANDLE	O parâmetro hContext não é válido.
Outros valores	Um código de erro. Para obter mais informações, consulte Valores retornados de cartão inteligente.

Comentários

Chame essa função para determinar se um identificador de contexto de cartão inteligente ainda é válido. Depois que um identificador de contexto de cartão inteligente tiver sido definido por SCardEstablishContext, ele poderá se tornar inativo se o serviço do gerenciador de recursos tiver sido desligado.

Exemplos

O exemplo a seguir mostra como determinar se um identificador de contexto de cartão inteligente é válido.

// Check the smart card context handle.
// hContext was set previously by SCardEstablishContext.

LONG    lReturn;
lReturn = SCardIsValidContext(hContext);
if ( SCARD_S_SUCCESS != lReturn )
{
    // Function failed; check return value.
    if ( ERROR_INVALID_HANDLE == lReturn )
        printf("Handle is invalid\n");
    else
    {
        // Some unexpected error occurred; report and bail out.
        printf("Failed SCardIsValidContext - %x\n", lReturn);
        exit(1);  // Or other appropriate error action.
    }
}
else
{
    // Handle is valid; proceed 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]
Plataforma de Destino	Windows
Cabeçalho	winscard.h
Biblioteca	Winscard.lib
DLL	Winscard.dll

Confira também

Scardestablishcontext