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 成員之下。

此函式會根據它是否成功或失敗，傳回不同的值。

傳回碼	Description
「成功」	SCARD_S_SUCCESS。
失敗	錯誤碼。如需詳細資訊，請參閱智慧卡傳回值。

注意

winscard.h 標頭會根據 UNICODE 預處理器常數的定義，將 SCardGetDeviceTypeId 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。