Share via

ISCardFileAccess::GetFileCapabilities-Methode

  • Artikel

[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 der 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 abgerufen werden sollen. 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 zugeordnet 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
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG
 Ungültiger Parameter.
E_POINTER
 Ein ungültiger 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 Fehlercode für intelligente Karte zurück, wenn eine intelligente 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

Siehe auch

ISCardFileAccess