Funzione SCardWriteCacheA (winscard.h)

Articolo
11/20/2024

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

Sintassi

LONG SCardWriteCacheA(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPSTR        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

Condividi tramite