Funzione SCardIsValidContext (winscard.h)

  • Articolo

La funzione SCardIsValidContext determina se un handle di contesto della smart card è valido.

Sintassi

LONG SCardIsValidContext(
  [in] SCARDCONTEXT hContext
);

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager può essere impostato da una chiamata precedente a SCardEstablishContext.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Codice restituito Descrizione
SCARD_S_SUCCESS
 Il parametro hContext è valido.
ERROR_INVALID_HANDLE
 Il parametro hContext non è valido.
Altri valori
 Codice di errore. Per altre informazioni, vedere Valori restituiti della smart card.

Commenti

Chiamare questa funzione per determinare se un handle di contesto della smart card è ancora valido. Dopo che un handle di contesto della smart card è stato impostato da SCardEstablishContext, potrebbe non essere valido se il servizio resource manager è stato arrestato.

Esempio

Nell'esempio seguente viene illustrato come determinare se un handle di contesto della smart card è valido.

// 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.
    // ...
}

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winscard.h
Libreria Winscard.lib
DLL Winscard.dll

Vedi anche

SCardEstablishContext