Freigeben über

SCardWriteCacheA-Funktion (winscard.h)

  • Artikel

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