SCardGetDeviceTypeIdW 関数 (winscard.h)

  • [アーティクル]

SCardGetDeviceTypeId 関数は、指定されたリーダー名のカード リーダーのデバイスの種類識別子を取得します。 この関数は、リーダーの状態には影響しません。

構文

LONG SCardGetDeviceTypeIdW(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCWSTR      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