SCardWriteCacheA-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardWriteCache-Funktion schreibt ein Name-Wert-Paar aus einem intelligenten Karte in den globalen Cache, der vom Smartcard-Resource Manager verwaltet wird.

Syntax

LONG SCardWriteCacheA(
  [in] SCARDCONTEXT hContext,
  [in] UUID         *CardIdentifier,
  [in] DWORD        FreshnessCounter,
  [in] LPSTR        LookupName,
  [in] PBYTE        Data,
  [in] DWORD        DataLen
);

Parameter

[in] hContext

Ein Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContext festgelegt.

[in] CardIdentifier

Ein Zeiger auf einen Wert, der die intelligente Karte eindeutig identifiziert, aus der das Name-Wert-Paar gelesen wurde.

[in] FreshnessCounter

Die aktuelle Revision der zwischengespeicherten Daten.

[in] LookupName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namensteil des Name-Wert-Paars enthält, das in den globalen Cache geschrieben werden soll.

[in] Data

Ein Zeiger auf ein Array von Bytewerten, die den Wertteil des Name-Wert-Paars enthalten, das in den globalen Cache geschrieben werden soll.

[in] DataLen

Die Größe des Datenpuffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird SCARD_S_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Rückgabecode/-wert	BESCHREIBUNG
SCARD_W_CACHE_ITEM_TOO_BIG 0x80100072	Die Größe des angegebenen Name-Wert-Paars überschreitet die maximale Größe, die für den globalen Cache definiert ist.

Hinweise

Hinweis

Der winscard.h-Header definiert SCardWriteCache als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
Bibliothek	Winscard.lib
DLL	Winscard.dll

Weitere Informationen

SCardReadCache

Freigeben über