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 メンバーの下に一覧表示されます。

戻り値

この関数は、成功するか失敗したかに応じて異なる値を返します。

リターン コード	説明
Success	SCARD_S_SUCCESS。
障害	エラー コード。 詳細については、「 スマート カードの戻り値」を参照してください。

注釈

注意

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

要件

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