SCardUIDlgSelectCardA 関数 (winscard.h)

SCardUIDlgSelectCard 関数は、スマート カード [カードの選択] ダイアログ ボックスを表示します。

構文

LONG SCardUIDlgSelectCardA(
  [in] LPOPENCARDNAMEA_EX unnamedParam1
);

パラメーター

[in] unnamedParam1

[カードの選択] ダイアログ ボックスのOPENCARDNAME_EX構造へのポインター。

戻り値

関数に [ カードの選択 ] ダイアログ ボックスが正常に表示された場合、戻り値はSCARD_S_SUCCESS。

関数が失敗した場合はエラー コードを返します。 詳細については、「 スマート カードの戻り値」を参照してください。

注釈

SCardUIDlgSelectCard 関数は、特定のスマート カードに接続するためのメソッドを提供します。 呼び出されると、この関数は、pDlgStruc パラメーターで指定されたOPENCARD_SEARCH_CRITERIA メンバーと一致する適切なスマート カードの検索を実行します。 pDlgStruc の dwFlags メンバーに応じて、この関数は次のアクションを実行します。

値	アクション
SC_DLG_FORCE_UI	スマート カード [カードの選択] ダイアログ ボックスからユーザーが選択したカードに接続します。
SC_DLG_MINIMAL_UI	1 つのスマート カードのみが条件を満たす場合はスマート カードを選択し、複数のスマート カードが条件を満たしている場合はユーザーの選択に関する情報を返します。
SC_DLG_NO_UI	使用可能な最初のカードを選択します。

 

この関数は 、GetOpenCardName を置き換えます。 GetOpenCardName 関数は、Microsoft Smart Card Base Components のバージョン 1.0 との下位互換性のために維持されます。

例

次の例は、スマート カード [カードの選択] ダイアログ ボックスを表示する方法を示しています。

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).

注意

winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardUIDlgSelectCard を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	winscard.h
Library	Scarddlg.lib
[DLL]	Scarddlg.dll

こちらもご覧ください

OPENCARDNAME_EX