SCardForgetReaderA 関数 (winscard.h)
SCardForgetReader 関数は、以前に導入された リーダー を、スマート カード サブシステムによる制御から削除します。 スマート カード データベースから削除されます。これには、追加された可能性のある リーダー グループ も含まれます。
構文
LONG SCardForgetReaderA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName
);
パラメーター
[in] hContext
リソース マネージャー コンテキストを識別するハンドル。 リソース マネージャー コンテキストは、SCardEstablishContextを
[in] szReaderName
スマート カード データベースから削除するリーダーの表示名。
戻り値
この関数は、成功するか失敗したかに応じて異なる値を返します。
| リターン コード | 形容 |
|---|---|
|
SCARD_S_SUCCESS。 |
|
エラー コード。 詳細については、「スマート カードの戻り値 を参照してください。 |
備考
指定したリーダーがリーダー グループの最後のメンバーである場合、リーダー グループも自動的に削除されます。
SCardForgetReader 関数はデータベース管理機能です。 その他のデータベース管理機能の詳細については、「スマート カード データベース管理機能の
例
次の例では、指定したカード リーダーの表示名をシステムから削除します。 この例では、lReturn が LONG
lReturn = SCardForgetReader(hContext,
TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReader\n");
手記
winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardForgetReader を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winscard.h |
| ライブラリ | Winscard.lib |
| DLL | Winscard.dll |
関連項目
SCardForgetReaderGroup の