Funzione SCardReadCacheW (winscard.h)
La funzione SCardReadCache recupera la parte del valore di una coppia nome-valore dalla cache globale gestita dalla Resource Manager smart card.
Sintassi
LONG SCardReadCacheW(
[in] SCARDCONTEXT hContext,
[in] UUID *CardIdentifier,
[in] DWORD FreshnessCounter,
[in] LPWSTR 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 contenente la parte del nome 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 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 smart card.
Codice/valore restituito | Descrizione |
---|---|
|
La coppia nome-valore specificata non è stata trovata nella cache globale. |
|
La coppia nome-valore specificata è stata 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
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 |