SCardListInterfacesA 函式 (winscard.h)

發行項
08/27/2023

SCardListInterfaces函式提供指定卡片所提供的介面清單。

呼叫端會提供先前導入子系統的智慧卡名稱，並接收卡片所支援的介面清單。

語法

LONG SCardListInterfacesA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szCard,
  [out]     LPGUID       pguidInterfaces,
  [in, out] LPDWORD      pcguidInterfaces
);

參數

[in] hContext

識別查詢之資源管理員內容的控制碼。資源管理員內容可由先前呼叫 SCardEstablishCoNtext來設定。此參數不可為 Null。

[in] szCard

智慧卡已導入智慧卡子系統的名稱。

[out] pguidInterfaces

介面識別碼陣列 (GUID) ，指出智慧卡支援的介面。如果此值為Null，SCardListInterfaces會忽略pcguidInterfaces中提供的陣列長度，傳回如果此參數不是pcguidInterfaces和成功程式碼，則會傳回的陣列大小。

[in, out] pcguidInterfaces

pcguidInterfaces陣列的大小，並接收傳回之陣列的實際大小。如果陣列大小指定為 SCARD_AUTOALLOCATE， 則 pcguidInterfaces 會轉換成 GUID 指標的指標，並接收包含陣列的記憶體區塊位址。此記憶體區塊必須與 SCardFreeMemory解除配置。

傳回值

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

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

備註

此函式不會重新導向，但在嘗試遠端桌面會話時呼叫函式並不會造成錯誤。這只表示結果會來自遠端電腦，而不是本機電腦。

SCardListInterfaces函式是資料庫查詢函式。如需其他資料庫查詢函式的詳細資訊，請參閱智慧卡資料庫查詢函式。

範例

下列範例顯示列出智慧卡的介面。

LPGUID          pGuids = NULL;
LONG            lReturn;
DWORD           cGuid = SCARD_AUTOALLOCATE;

// Retrieve the list of interfaces.
lReturn = SCardListInterfaces(NULL,
                              (LPCSTR) "MyCard",
                              (LPGUID)&pGuids,
                              &cGuid );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardListInterfaces\n");
    exit(1);   // Or other appropriate action
}

if ( 0 != cGuid )
{
    // Do something with the array of Guids.
    // Remember to free pGuids when done (by SCardFreeMemory).
    // ...
}

注意

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

規格需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	winscard.h
程式庫	Winscard.lib
Dll	Winscard.dll