ISCardFileAccess::GetFileCapabilities-Methode
[Die GetFileCapabilities-Methode ist für die Verwendung in den Im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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 GetFileCapabilities-Methode ruft eine Liste von Dateifunktionen aus der aktuellen Datei ab.
Syntax
HRESULT GetFileCapabilities(
[in, out] LPTLV_TABLE *ppProperties,
[in, out] LONG *plProperties,
[in] SCARD_FLAGS Flags
);
Parameter
-
ppProperties [ in, out]
-
Zeiger auf TLV-Strukturen (Tag, Länge, Wert). Bei der Eingabe gibt dieser Parameter die Dateien an, für die Eigenschaften erhalten werden. in der Ausgabe enthält dieser Parameter die Eigenschaften. Das folgende Beispiel ist eine Definition der TLV-Struktur.
#include <windows.h> typedef struct { DWORD Tag; DWORD Length; BYTE[] Value; BOOL Valid; } TLV;Weitere Informationen zu TLV-Strukturen finden Sie unter https://pcscworkgroup.com/ .
-
plProperties [ in, out]
-
Zeiger auf die Anzahl der TLV-Einträge in ppProperties.
-
Flaggen [ In]
-
Gibt an, ob sicheres Messaging verwendet und Daten vorab zugewiesen werden müssen.
-
SC _ FL _ SECURE _ MESSAGING
-
SC _ FL _ PREALLOCATED
-
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Ungültiger Parameter. |
|
Ein fehlerhafter Zeiger wurde übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
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 Smartcardfehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung zu erfüllen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |