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