ISCardManage-Schnittstelle
[Die ISCardManage-Schnittstelle ist ab Windows Server 2008, Windows Vista und Windows Server 2003 mit Service Pack 1 (SP1) und höher nicht mehr für die Verwendung verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]
Die folgende Schnittstellendefinition wird als Standard bereitgestellt, der beim Entwickeln eines Smartcard-Dienstanbietersbefolgt werden kann.
Die ISCardManage-Schnittstelle muss bereitgestellt werden. Es wird zum Anfügen an eine bestimmte Smartcard oder einen Reader,zum Erstellen anderer optionaler Schnittstellen zum Ausführen bestimmter Smartcardfunktionen, zum Sperren einer bestimmten Smartcard für die exklusive Verwendung und zum Abrufen des Status einer Smartcard oder eines Lesers verwendet. Als Gruppe können diese Dienste für die Verwaltung eines klar definierten Kontexts verantwortlich sein, in dem eine Anwendung mit einer Smartcard oder einem Leserkommunizieren kann.
Im Folgenden finden Sie eine typische Verwendung der ISCardManage-Schnittstelle.
So stellen Sie eine Verbindung mit einer Smartcard her
- Erstellen Sie die ISCardManage-Schnittstelle, die der Karte zugeordnet ist.
- Verbinden zu einer Smartcard durch Anfügen an einen bestimmten Smartcardleser (AttachByIFD) oder mithilfe eines zuvor erworbenen Handles (AttachByHandle).
- Erstellen Sie andere Schnittstellen zum Ausführen von Smartcardvorgängen (CreateCardAuth, CreateFileAccess, CreateCHVerificationoder CreateInterface).
- Geben Sie die Karte frei (Trennen ).
- Geben Sie die ISCardManage-Schnittstelle und andere nach Bedarf frei.
Members
Die ISCardManage-Schnittstelle erbt von der IDispatch-Schnittstelle. ISCardManage verfügt auch über diese Typen von Membern:
Methoden
Die ISCardManage-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| AttachByHandle | Ermöglicht einer Anwendung das Erstellen einer Kommunikationsverbindung mit einer Smartcard mithilfe eines Handles, das vom Smartcardressourcen-Managerzurückgegeben wird. |
| AttachByIFD | Ermöglicht es einer Anwendung, die Einrichtung eines Kontexts für einen bestimmten Reader anzufordern, auf den mit einem Anzeigenamen verwiesen wird. |
| CreateCardAuth | Ermöglicht die Erstellung einer ISCardAuth-Schnittstelle. |
| CreateCHVerification | Ermöglicht die Erstellung einer ISCardVerify-Schnittstelle. |
| CreateFileAccess | Ermöglicht die Erstellung einer ISCardFileAccess-Schnittstelle. |
| CreateInterface | Ermöglicht die Erstellung einer Schnittstelle. |
| Trennen | Gibt die Anlage an eine bestimmte Smartcard oder einen bestimmten Reader frei, die bzw. der von AttachByHandle bzw. AttachByIFD zugeordnet wird. |
| Verbindung wiederherstellen | Ermöglicht es einer Anwendung, erneut eine Verbindung mit einer Smartcard oder einem Reader herzustellen, ohne dass ein Detach gefolgt von AttachByHandle bzw. AttachByIFD ausgegeben werden muss. |
| SCardLock | Sperrt eine verbundene Smartcard oder einen verbundenen Reader für die exklusive Verwendung. |
| SCardUnlock | Gibt die exklusive Verwendung der verbundenen Smartcard oder des verbundenen Readers frei. |
| Status | Ermöglicht einer Anwendung, den aktuellen Status der Smartcard oder des Lesers abzurufen. |
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |