GetOpenCardNameA-Funktion (winscard.h)
Die GetOpenCardName--Funktion zeigt das Dialogfeld Smartcard Dialogfeld "Karte auswählen" an. Rufen Sie die Funktion SCardUIDlgSelectCard anstelle von GetOpenCardNameauf. Die GetOpenCardName--Funktion wird für die Abwärtskompatibilität mit Version 1.0 der Microsoft SmartCard-Basiskomponenten beibehalten, jedoch werden Aufrufe an GetOpenCardNameSCardUIDlgSelectCardzugeordnet.
Syntax
LONG GetOpenCardNameA(
[in] LPOPENCARDNAMEA unnamedParam1
);
Parameter
[in] unnamedParam1
Ein Zeiger auf die OPENCARDNAME Struktur für das Dialogfeld "Karte auswählen".
Rückgabewert
Die Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.
| Rückgabecode | Beschreibung |
|---|---|
|
SCARD_S_SUCCESS. |
|
Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte. |
Bemerkungen
Anmerkung
Der winscard.h-Header definiert GetOpenCardName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winscard.h |
| Library | Scarddlg.lib |
| DLL- | Scarddlg.dll |