ISCardFileAccess::Create-Methode

Artikel
06/13/2023

[Die Create-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 Create-Methode erstellt eine Datei an einem bestimmten Speicherort innerhalb des Smart Karte Dateisystems.

Syntax

HRESULT Create(
  [in] REFTYPE      refType,
  [in] BSTR         bstrPathSpec,
  [in] TLV_TABLE    TLV,
  [in] SCARD_FLAGS  flags,
  [in] LPBYTEBUFFER pDataBuffer
);

Parameter

refType [in]

In bstrPathSpec verwendete Verweistyp.

SC_TYPE_BY_NAME
SC_TYPE_BY_ID
SC_TYPE_BY_SHORT
SC_TYPE_BY_ANY

bstrPathSpec [in]

Datei-ID, die im aktuellen Kontext erstellt werden soll.

TLV [in]

Liste der TLV-Strukturen (Tag, Länge, Wert), deren Werte festgelegt werden müssen.

Flags [in]

Gibt an, ob sicheres Messaging verwendet und Daten vorab zugeordnet werden müssen.

SC_FL_SECURE_MESSAGING
SC_FL_PREALLOCATED

pDataBuffer [in]

Zeiger auf vorab zugeordnete Daten.

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 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

Freigeben über