Función SCardIsValidContext (winscard.h)

  • Artículo

La función SCardIsValidContext determina si un identificador de contexto de tarjeta inteligente es válido.

Sintaxis

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos. El contexto del administrador de recursos se puede establecer mediante una llamada anterior a SCardEstablishContext.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Código devuelto Descripción
SCARD_S_SUCCESS
 El parámetro hContext es válido.
ERROR_INVALID_HANDLE
 El parámetro hContext no es válido.
Otros valores
 Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

Llame a esta función para determinar si un identificador de contexto de tarjeta inteligente sigue siendo válido. Una vez que SCardEstablishContext ha establecido un identificador de contexto de tarjeta inteligente, es posible que no sea válido si el servicio de Resource Manager se ha cerrado.

Ejemplos

En el ejemplo siguiente se muestra cómo determinar si un identificador de contexto de tarjeta inteligente es 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 Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winscard.h
Library Winscard.lib
Archivo DLL Winscard.dll

Consulte también

SCardEstablishContext