Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Die AttachByHandle-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 AttachByHandle-Methode fügt das ISCard-Objekt an ein geöffnetes und konfiguriertes Smart Karte Handle an.
Syntax
HRESULT AttachByHandle(
[in] HSCARD hCard
);
Parameter
-
hCard [in]
-
Ein Handle für eine offene Verbindung mit einem intelligenten Karte.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Operation erfolgreich abgeschlossen. |
|
Der hCard-Parameter ist ungültig. |
Bemerkungen
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.
Wenn Sie mit der Verwendung des Handles fertig sind, lassen Sie die Anlage los, indem Sie die ISCard::D etach-Methode aufrufen.
Beispiele
Das folgende Beispiel zeigt das Anfügen an ein intelligentes Karte Handle.
HRESULT hr;
// hSC is of type HSCARD and has been previously assigned.
// Attach SCard to the smart card using the value in hSC.
hr = pISCard->AttachByHandle(hSC);
if (FAILED(hr))
{
printf("Failed AttachByHandle\n");
// Take other error handling action as needed.
}
// Proceed using attached reader.
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 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCard ist definiert als 1461AAC3-6810-11D0-918F-00AA00C18068 |
Weitere Informationen