SCardReadCacheA-Funktion (winscard.h)

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.

Bemerkungen

Anforderungen

Siehe auch

SCardWriteCache-