Condividi tramite


Funzione SCardWriteCacheW (winscard.h)

La funzione SCardWriteCache scrive una coppia nome-valore da una smart card nella cache globale gestita dal Resource Manager della smart card.

Sintassi

LONG SCardWriteCacheW(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPWSTR       LookupName,
  [in] PBYTE        Data,
  [in] 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 la smart card da cui è stata letta la coppia nome-valore.

[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 da scrivere nella cache globale.

[in] Data

Puntatore a una matrice di valori di byte che contengono la parte valore della coppia nome-valore da scrivere nella cache globale.

[in] DataLen

Dimensione, 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_TOO_BIG
0x80100072
Le dimensioni della coppia nome-valore specificata superano le dimensioni massime definite per la cache globale.

Osservazioni

Nota

L'intestazione winscard.h definisce SCardWriteCache 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

SCardReadCache