ISCardFileAccess::GetProperties-Methode

Artikel
06/13/2023

[Die GetProperties-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 GetProperties-Methode ruft die primitiven Daten ab, auf die von TLVs verwiesen wird (Tag, Länge, Wert) für das angegebene Objekt.

Syntax

HRESULT GetProperties(
  [in]      REFTYPE     refType,
  [in]      BSTR        bstrPathSpec,
  [in]      SCARD_FLAGS flags,
  [in, out] LPTLV_TABLE *ppTLV
);

Parameter

refType [in]

In bstrNewDir verwendete Verweistyp.

SC_TYPE_BY_NAME
SC_TYPE_BY_ID
SC_TYPE_BY_SHORT
SC_TYPE_BY_ANY

bstrPathSpec [in]

Datei.

Flags [in]

Gibt an, ob sicheres Messaging verwendet werden soll.

SC_FL_SECURE_MESSAGING

ppTLV [ein, aus]

Zeiger auf TLV-Strukturen, deren Wert abgerufen wurde.

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

Siehe auch

ISCardFileAccess

Freigeben über