SCardUIDlgSelectCardA-Funktion (winscard.h)

Die SCardUIDlgSelectCard--Funktion zeigt das Dialogfeld Smartcard Karte auswählen an.

Syntax

LONG SCardUIDlgSelectCardA(
  [in] LPOPENCARDNAMEA_EX unnamedParam1
);

Parameter

[in] unnamedParam1

Zeigen Sie auf die struktur OPENCARDNAME_EX für das Dialogfeld Karte auswählen.

Rückgabewert

Wenn die Funktion erfolgreich das Dialogfeld Karte auswählen anzeigt, wird der Rückgabewert SCARD_S_SUCCESS.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Bemerkungen

Die SCardUIDlgSelectCard--Funktion stellt eine Methode zum Herstellen einer Verbindung mit einer bestimmten Smartcardbereit. Wenn diese Funktion aufgerufen wird, führt diese Funktion eine Suche nach geeigneten Smartcards aus, die dem OPENCARD_SEARCH_CRITERIA Element entsprechen, das vom pDlgStruc Parameter angegeben ist. Je nach dwFlags Mitglied von pDlgStrucführt diese Funktion die folgenden Aktionen aus.

Diese Funktion ersetzt GetOpenCardName. Die GetOpenCardName-Funktion wird zur Abwärtskompatibilität mit Version 1.0 der Microsoft SmartCard-Basiskomponenten beibehalten.

Beispiele

Das folgende Beispiel zeigt, wie die Smartcard Dialogfeld "Karte auswählen" angezeigt wird.

SCARDCONTEXT     hSC;
OPENCARDNAME_EX  dlgStruct;
WCHAR            szReader[256];
WCHAR            szCard[256];
LONG             lReturn;

// Establish a context.
// It will be assigned to the structure's hSCardContext field.
lReturn = SCardEstablishContext(SCARD_SCOPE_USER,
                                NULL,
                                NULL,
                                &hSC );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardEstablishContext\n");
    exit(1);
}

// Initialize the structure.
memset(&dlgStruct, 0, sizeof(dlgStruct));
dlgStruct.dwStructSize = sizeof(dlgStruct);
dlgStruct.hSCardContext = hSC;
dlgStruct.dwFlags = SC_DLG_FORCE_UI;
dlgStruct.lpstrRdr = (LPSTR) szReader;
dlgStruct.nMaxRdr = 256;
dlgStruct.lpstrCard = (LPSTR) szCard;
dlgStruct.nMaxCard = 256;
dlgStruct.lpstrTitle = (LPSTR) "My Select Card Title";

// Display the select card dialog box.
lReturn = SCardUIDlgSelectCard(&dlgStruct);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardUIDlgSelectCard - %x\n", lReturn );
else
    printf("Reader: %S\nCard: %S\n", szReader, szCard );

// Release the context (by SCardReleaseContext - not shown here).

Anforderungen

Siehe auch

OPENCARDNAME_EX