Funzione SCardWriteCacheW (winscard.h)

Articolo
03/13/2024

La funzione SCardWriteCache scrive una coppia nome-valore da una smart card alla cache globale gestita dalla smart card Resource Manager.

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 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 la smart card da cui è stata letto 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

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

Commenti

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 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

Vedi anche

SCardReadCache

Condividi tramite