Funzione SCardReadCacheA (winscard.h)

Articolo
11/20/2024

La funzione SCardReadCache recupera la parte del valore di una coppia nome-valore dalla cache globale gestita dalla Gestione risorse 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 gestione risorse . 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 contenente 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 del valore della coppia nome-valore specificata dal parametro LookupName.

[out] DataLen

Puntatore alle dimensioni, in byte, del buffer 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winscard.h
libreria	Winscard.lib
dll	Winscard.dll

Vedere anche

SCardWriteCache

Condividi tramite