SCardReadCacheA-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardReadCache-Funktion ruft den Wertteil eines Name-Wert-Paares aus dem globalen Cache ab, der vom SmartCard-Resource Manager verwaltet 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 Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext wird durch einen vorherigen Aufruf von SCardEstablishContext festgelegt.

[in] CardIdentifier

Ein Zeiger auf einen Wert, der eine intelligente Karte eindeutig identifiziert. Das Name-Wert-Paar, das diese Funktion aus dem globalen Cache liest, ist diesem intelligenten Karte zugeordnet.

[in] FreshnessCounter

Die aktuelle Revision der zwischengespeicherten Daten.

[in] LookupName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namensteil des Name-Wert-Paares enthält, für das der Wertteil abgerufen werden soll.

[out] Data

Ein Zeiger auf ein Array von Bytewerten, die den Wertteil des durch den LookupName-Parameter angegebenen Name-Wert-Paares enthalten.

[out] DataLen

Ein Zeiger auf die Größe des Datenpuffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie SCARD_S_SUCCESS zurück.

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

Hinweise

Hinweis

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 nicht codierungsneutralem Code 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

SCardWriteCache

Freigeben über