Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die SCardWriteCache--Funktion schreibt ein Name-Wert-Paar aus einer Smartcard in den globalen Cache, der vom SmartCard Resource Managerverwaltet wird.
Syntax
LONG SCardWriteCacheW(
[in] SCARDCONTEXT hContext,
[in] UUID *CardIdentifier,
[in] DWORD FreshnessCounter,
[in] LPWSTR 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 |
|---|---|
|
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 |