Funzione SCardReadCacheA (winscard.h)

  • Articolo

La funzione SCardReadCache recupera la parte del valore di una coppia nome-valore dalla cache globale gestita dal Resource Manager smart card.

Sintassi

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        LookupName,
  [out] PBYTE        Data,
  [out] DWORD        *DataLen
);

Parametri

[in] hContext

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

[in] CardIdentifier

Puntatore a un valore che identifica in modo univoco una smart card. La coppia nome-valore che questa funzione legge dalla cache globale è associata a questa smart card.

[in] FreshnessCounter

Revisione corrente dei dati memorizzati nella cache.

[in] LookupName

Puntatore a una stringa con terminazione Null che contiene la parte name della coppia nome-valore per cui recuperare la parte del valore.

[out] Data

Puntatore a una matrice di valori di byte che contengono la parte valore della coppia nome-valore specificata dal parametro LookupName .

[out] DataLen

Puntatore alla dimensione, in byte, del buffer di dati .

Valore restituito

Se la funzione ha esito positivo, restituisce SCARD_S_SUCCESS.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni, vedere Valori restituiti della smart card.

Codice/valore restituito Descrizione
SCARD_W_CACHE_ITEM_NOT_FOUND
0x80100070
 La coppia nome-valore specificata non è stata trovata nella Cache globale.
SCARD_W_CACHE_ITEM_STALE
0x80100071
 La coppia nome-valore specificata era precedente alla richiesta ed è stata eliminata dalla cache.

Commenti

Nota

L'intestazione winscard.h definisce SCardReadCache come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winscard.h
Libreria Winscard.lib
DLL Winscard.dll

Vedi anche

SCardWriteCache