ISCardFileAccess::Read-Methode

Artikel
06/13/2023

[Die Read-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]

Die Read-Methode liest und gibt die angegebenen Daten aus einer bestimmten Datei zurück.

Syntax

HRESULT Read(
  [in]  HSCARD_FILE  hFile,
  [in]  LONG         *lBytesToRead,
  [in]  SCARD_FLAGS  flags,
  [out] LPBYTEBUFFER *ppBuffer
);

Parameter

hFile [in]

Handle der geöffneten Datei, auf die zugegriffen werden soll.

lBytesToRead [in]

Länge der zu lesenden Daten (ein) oder Anzahl der zu lesenden Bytes (out). Gibt eine Liste von Dateien als Array von BSTRs zurück.

Flags [in]

Gibt an, ob sicheres Messaging verwendet werden soll.

SC_FL_SECURE_MESSAGING

ppBuffer [out]

Ein IByteBuffer-Objekt , das die gelesenen Daten enthält.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Rückgabecode	Beschreibung
S_OK	Operation erfolgreich abgeschlossen.
E_INVALIDARG	Ungültiger Parameter.
E_POINTER	Ein fehlerhafter Zeiger wurde übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Eine Liste aller von dieser Schnittstelle definierten Methoden finden Sie unter ISCardFileAccess.

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003

Weitere Informationen

ISCardFileAccess

Freigeben über