SCardWriteCacheA-Funktion (winscard.h)

Artikel
11/20/2024

Die SCardWriteCache--Funktion schreibt ein Name-Wert-Paar aus einer Smartcard in den globalen Cache, der vom SmartCard Resource Managerverwaltet 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 Kontext des Ressourcen-Managersidentifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContextfestgelegt.

[in] CardIdentifier

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

[in] FreshnessCounter

Die aktuelle Überarbeitung der zwischengespeicherten Daten.

[in] LookupName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namensteil des Namenswertpaars enthält, der in den globalen Cache geschrieben werden soll.

[in] Data

Ein Zeiger auf ein Array von Bytewerten, die den Wertteil des Namenswertpaars enthalten, um in den globalen Cache zu schreiben.

[in] DataLen

Die Größe des Daten puffers in Byte.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird SCARD_S_SUCCESSzurückgegeben.

Wenn die Funktion fehlschlägt, wird eine der folgenden Fehlercodes zurückgegeben. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Zurückgeben von Code/Wert	Beschreibung
SCARD_W_CACHE_ITEM_TOO_BIG 0x80100072	Die Größe des angegebenen Namens-Wert-Paares überschreitet die für den globalen Cache definierte maximale Größe.

Bemerkungen

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winscard.h
Library	Winscard.lib
DLL-	Winscard.dll

Siehe auch

SCardReadCache-

Freigeben über