SCardReadCacheA-Funktion (winscard.h)

Artikel
11/20/2024

Die SCardReadCache Funktion ruft den Wertanteil eines Namens-Wert-Paars aus dem globalen Cache ab, der vom SmartCard Resource Managerverwaltet wird.

Syntax

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        LookupName,
  [out] PBYTE        Data,
  [out] 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 eine Smartcard eindeutig identifiziert. Das Name-Wert-Paar, das diese Funktion aus dem globalen Cache liest, ist dieser Smartcard zugeordnet.

[in] FreshnessCounter

Die aktuelle Überarbeitung der zwischengespeicherten Daten.

[in] LookupName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namensteil des Namens-Wert-Paares enthält, für den der Wertteil abgerufen werden soll.

[out] Data

Ein Zeiger auf ein Array von Bytewerten, die den Wertteil des durch den parameter LookupName Parameter angegebenen Wertpaars enthalten.

[out] DataLen

Ein Zeiger auf 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_NOT_FOUND 0x80100070	Das angegebene Name-Wert-Paar wurde im globalen Cache nicht gefunden.
SCARD_W_CACHE_ITEM_STALE 0x80100071	Das angegebene Name-Wert-Paar war älter als angefordert und wurde aus dem Cache gelöscht.

Bemerkungen

Anmerkung

Der winscard.h-Header definiert SCardReadCache 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

SCardWriteCache-

Freigeben über