ISCardLocate::ConfigureCardNameSearch メソッド
[ ConfigureCardNameSearch メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
ConfigureCardNameSearch メソッドは、スマート カードの検索で使用するカード名を指定します。
構文
HRESULT ConfigureCardNameSearch(
[in] LPSAFEARRAY pCardNames,
[in] LPSAFEARRAY pGroupNames,
[in] BSTR bstrTitle,
[in] LONG lFlags
);
パラメーター
-
pCardNames [in]
-
BSTR 形式のカード名の Automation セーフ配列へのポインター。
-
pGroupNames [in]
-
検索に追加する BSTR フォームのカード/リーダー グループの名前の Automation セーフ配列へのポインター。
-
bstrTitle [in]
-
検索共通コントロールのダイアログ ボックスのタイトル。
-
lFlags [in]
-
ユーザー インターフェイスを表示するタイミングを指定します。
値 説明 - SC_DLG_MINIMAL_UI
呼び出し元のアプリケーションによって検索されるカードが見つからないため、リーダーで使用できない場合にのみ、ダイアログ ボックスを表示します。 これにより、カードを検出し、(内部ダイアログ ボックス メカニズムまたはユーザー コールバック関数を使用して) 接続し、呼び出し元のアプリケーションに返すことができます。 - SC_DLG_NO_UI
検索結果に関係なく、UI の表示を行いません。 - SC_DLG_FORCE_UI
検索結果に関係なく UI を表示します。
戻り値
メソッドは、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
無効なパラメーター。 |
|
pCardNames または pGroupNames で不適切なポインターが渡されました。 |
|
メモリが不足しています。 |
解説
スマート カードを見つけるには、FindCard を呼び出します。
このインターフェイスによって提供されるすべてのメソッドの一覧については、「 ISCardLocate」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
| ヘッダー |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| IID |
IID_ISCardLocateは 1461AACD-6810-11D0-918F-00AA00C18068 として定義されます |
関連項目