SCardListInterfacesA 函式（winscard.h）

發行項
11/20/2024

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中提供的數位長度，傳回此參數未 NULL 傳回的陣列大小，以 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 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winscard.h
連結庫	Winscard.lib
DLL	Winscard.dll