SCardGetDeviceTypeIdA 関数 (winscard.h)
SCardGetDeviceTypeId 関数は、指定されたリーダー名のカード リーダーのデバイスの種類識別子を取得します。 この関数は、リーダーの状態には影響しません。
構文
LONG SCardGetDeviceTypeIdA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName,
[in, out] LPDWORD pdwDeviceTypeId
);
パラメーター
[in] hContext
クエリのリソース マネージャー コンテキストを識別するハンドル。 リソース マネージャーのコンテキストを設定するには、 SCardEstablishContext 関数を呼び出します。 このパラメーターは NULL にはできません。
[in] szReaderName
リーダー名。 この値を取得するには、 SCardListReaders 関数を 呼び出します。
[in, out] pdwDeviceTypeId
実際のデバイスの種類の識別子。 この関数によって返されるリーダー型の一覧は、SCARD_READER_CAPABILITIES構造体の ReaderType メンバーの下に一覧表示されます。
戻り値
この関数は、成功するか失敗したかに応じて異なる値を返します。
リターン コード | 説明 |
---|---|
|
SCARD_S_SUCCESS。 |
|
エラー コード。 詳細については、「 スマート カードの戻り値」を参照してください。 |
注釈
注意
winscard.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SCardGetDeviceTypeId を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winscard.h |
[DLL] | Winscard.dll |